2012-02-07 Team meeting » History » Version 5

Sybille Peters, 2020-02-07 15:20

1 1 Sybille Peters
h1. 2020-02-07 Team meeting (slack call) - additional call
2
 
3
Attendees: Martin Bless, Sybille Peters, Daniel Siepmann
4
Benjamin Kott (reports about infrastructure)
5
 
6
Beginning of the meeting: 14:00 CET (Berlin) UTC+01:00)
7
 
8
1 hour planned
9
 
10
11
h2. Welcome
12
 
13
* How is everybody doing?
14
 
15
 
16
h2. Achievements
17
 
18
* a lot ...
19
 
20
 
21
h2. Agenda - today, here
22
 
23
What do we want to talk about today?
24
25 3 Sybille Peters
formatting for definition lists (reference tables with type, default,  etc.) issue: https://github.com/TYPO3-Documentation/TYPO3CMS-Guide-HowToDocument/issues/57#issuecomment-508416565
26
27
* Martin: Use confval directive: https://docs.typo3.org/m/typo3/demo-t3SphinxThemeRtd/master/en-us/Directives/confval.html
28 1 Sybille Peters
    (is used in documentation of sphinx project)
29 3 Sybille Peters
* is currently used in surf documentation: https://docs.typo3.org/other/typo3/surf/2.0/en-us/ApiReference/Task/Test/HttpTestTask.html
30
* important: empty line after confval
31
* :default: and :type: have specific meaning, are 
32
* advantages:
33
 
34
  * HTML formatting automatically created  
35
  * will automatically added to index
36
  * confval text role is added automatically
37
  * (previously, we had to add an additional header, this is now no longer necessary)
38 1 Sybille Peters
39
Leftovers from last meeting:
40
41
* acknowledgements: 
42
    - see recommendations by Thomas + Stefan
43
* search: how to proceed
44
  * TYPO3 inc must make infrastructure available, currently not possible yet
45
* Docker / theme
46 4 Sybille Peters
47 1 Sybille Peters
   * Docker currently already running with new theme (develop)
48
   * python package currently static
49
   * very good new features, actions etc. 
50 4 Sybille Peters
51 1 Sybille Peters
* sprints
52
   
53
  combined sprints:
54
      Suggestions so far:
55
March (13. - 15.) - Zürich (Server Team) (max 6 persons) Fr-So
56
April (20 - 22.) Combined Sprint Düsseldorf Mo-Mi
57
July (28. - 29.) Developer Days - Karlsruhe Di-Mi
58
Sep (14. - 16.) Hof (or 28 - 30) Mo-Mi
59
Nov (2. - 4.) Düsseldorf (after Rhein Ruhr Camp) Mo-Mi
60
61
62
* Doc team: roles, responsibilities, decisions: https://docs.google.com/document/d/1Y65SCiyeg0wnIuOk-oXQLKa26liJe6pul0vJ83I0fiQ/edit?usp=sharing
63
  * currently not enough people
64
65
* title capitalization: https://decisions.typo3.org/t/title-capitalization-in-the-docs-revisited/562
66
   
67
   Martin: I once came to the conclusion that the Microsoft Writing Style Guide would be best. It uses "sentence capitalization" as propose in the decision.
68
   Plus it has much more advice and word lists. https://docs.microsoft.com/de-de/style-guide/welcome/
69
   
70
  * Microsoft style guide
71
  * readthedocs / Slack
72
73
* Benjamin Kott
74 5 Sybille Peters
75 1 Sybille Peters
  * infrastructure problem
76
  * currently no docs rendering (not possible before end of next week)
77
  * will migrate to GitHub (from bitbucket)
78
79
80
81
Left over for next meeting
82
83
84
* Priority tasks 2020: https://docs.google.com/document/d/14PaKXZCWqtwCc6vc_R2AKxcdv8fXQGh6rtgjA5zmAGw/edit?usp=sharing
85
86
* get docs updated (changelog)
87
  * how to handle master / when to make changes (before release / after)
88
* viewhelper reference Fluid: how to proceed
89
90
91
* system extensions not rerendered for version <= 7.6. Was intentional. Can we fix this?
92
  * https://docs.typo3.org/typo3cms/extensions/fluid_styled_content/7.6/Index.html
93
94
95
96
97
h2. To do
98
 
99
To do or doing in real life in TYPO3 documentation:
100
 
101
* Martin will send Sybille some resources info about style guides, Slack channel / readthedocs
102
* Sybille: acknowledgments continue
103
* everyone: check dates for combined sprints, try to meet up for a sprint
104
  (we may also organize our own sprint)
105
106
107
108
h2. What we actually did in this meeting
109
110
see above
111
112
 
113
h2. Next meeting
114
 
115
The next regular meeting is planned for the 3rd Friday of the month: 
116
 
117
Feb 21, 2020
118
 
119
14:00 CET (Berlin) UTC+01:00
120
121
https://notes.typo3.org/p/T3DocTeam-2020-02-21
122
 
123
124
Planned end of meeting 15:00 CET.