We had our kickoff meeting yesterday, thanks to everyone who came, especially those who
stayed up late or woke up early to attend. Here are my notes from the meeting, please feel
free to reply to this message if you want to add anything. I've also put these up on
* Introduction from Frank, who leads the SUSE documentation team, about the way the docs
) works currently. Docs are written in Docbook XML,
and use the DAPS toolchain. Repo is open to PRs from anyone who wishes to contribute.
* Discussion about whether a new guide could be added directly to the repo, or whether we
should start a different/new repo. Frank confirmed that a new guide could be added to the
existing docs repo, and no new repo would be required.
* Adrien outlined the video proposal, a short series of videos for newcomers. Discussion
of the value of video offerings, and general agreement that they would bring value.
* Discussion about the existing wiki, and comparison to how other projects (KDE, Ubuntu,
etc) organise their documentation between wiki, formal docs, videos, forums, etc.
* Discussion about having a central site to allow people to choose which form of
documentation they would prefer. openSUSE has many domains available, but doc.opensuse.org
seems to be the most reasonable. The code for that site is in github
). This is probably the best starting point for this
_Action item_ (Everyone) Take a look at the doc-o-o GH repo, request access, and think
about how you would like to update it to act as a documentation portal.
Additionally, we would like to have a redirect from the main opensuse.org
(possibly in the
form of a 'documentation' link in the top right hand corner.
_Action item_ (Frank & Lana) Determine who owns that site and how to get the link
* Housekeeping topics: Lana proposed an alternating schedule and timezone for these
meetings, which means everyone should be able to attend at least every couple of weeks.
_Action item_ (Lana) Set up meeting schedule and send out details.
* Discussion about working out how to get started. Frank suggested we do some
_Action item_ (Everyone) Add ideas for docs projects we want to tackle to the wiki, for
prioritisation and planning in future meetings.
Thanks, looking forward to meeting you all again soon!
On 10/09/2020 14:52, Lana Brindley wrote:
After some discussion here and on Telegram, we have scheduled a kickoff meeting for next
Thursday 17 Sept at 0600 UTC at https://meet.opensuse.org/opensuse-docs
. Please have a
think about what you would like to see in the openSUSE docs and add agenda items to the
wiki here: https://en.opensuse.org/Documentation:Meetings
In the meantime, feel free to come along to our new Telegram group:
Thanks for the great discussion, can't wait to chat more next week!
Technical Writer - SUSE Manager
"The question is," said Alice, "whether you
can make words mean so many different things."
To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org
To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org