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

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 6 Sybille Peters
88 1 Sybille Peters
  * how to handle master / when to make changes (before release / after)
89 6 Sybille Peters
90 1 Sybille Peters
* viewhelper reference Fluid: how to proceed
91
92
93
* system extensions not rerendered for version <= 7.6. Was intentional. Can we fix this?
94
  * https://docs.typo3.org/typo3cms/extensions/fluid_styled_content/7.6/Index.html
95
96
97
98
99
h2. To do
100
 
101
To do or doing in real life in TYPO3 documentation:
102
 
103
* Martin will send Sybille some resources info about style guides, Slack channel / readthedocs
104
* Sybille: acknowledgments continue
105
* everyone: check dates for combined sprints, try to meet up for a sprint
106
  (we may also organize our own sprint)
107
108
109
110
h2. What we actually did in this meeting
111
112
see above
113
114
 
115
h2. Next meeting
116
 
117
The next regular meeting is planned for the 3rd Friday of the month: 
118
 
119
Feb 21, 2020
120
 
121
14:00 CET (Berlin) UTC+01:00
122
123
https://notes.typo3.org/p/T3DocTeam-2020-02-21
124
 
125
126
Planned end of meeting 15:00 CET.