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

Sybille Peters, 2020-02-07 15:19

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
  * infrastructure problem
75
  * currently no docs rendering (not possible before end of next week)
76
  * will migrate to GitHub (from bitbucket)
77
78
79
80
Left over for next meeting
81
82
83
* Priority tasks 2020: https://docs.google.com/document/d/14PaKXZCWqtwCc6vc_R2AKxcdv8fXQGh6rtgjA5zmAGw/edit?usp=sharing
84
85
* get docs updated (changelog)
86
  * how to handle master / when to make changes (before release / after)
87
* viewhelper reference Fluid: how to proceed
88
89
90
* system extensions not rerendered for version <= 7.6. Was intentional. Can we fix this?
91
  * https://docs.typo3.org/typo3cms/extensions/fluid_styled_content/7.6/Index.html
92
93
94
95
96
h2. To do
97
 
98
To do or doing in real life in TYPO3 documentation:
99
 
100
* Martin will send Sybille some resources info about style guides, Slack channel / readthedocs
101
* Sybille: acknowledgments continue
102
* everyone: check dates for combined sprints, try to meet up for a sprint
103
  (we may also organize our own sprint)
104
105
106
107
h2. What we actually did in this meeting
108
109
see above
110
111
 
112
h2. Next meeting
113
 
114
The next regular meeting is planned for the 3rd Friday of the month: 
115
 
116
Feb 21, 2020
117
 
118
14:00 CET (Berlin) UTC+01:00
119
120
https://notes.typo3.org/p/T3DocTeam-2020-02-21
121
 
122
123
Planned end of meeting 15:00 CET.