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

Sybille Peters, 2020-02-07 15:16

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