[opensuse-doc] Kickoff Meeting
Hi everyone, 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: https://t.me/opensuse_docs Thanks for the great discussion, can't wait to chat more next week! Lana -- Lana Brindley @Loquacities 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@opensuse.org To contact the owner, e-mail: opensuse-doc+owner@opensuse.org
Hi everyone, 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 https://en.opensuse.org/Documentation:Meetings#Kickoff_meeting:_17_September... for posterity. Attendees: Andrés Adrien Attila Frank Lana * Introduction from Frank, who leads the SUSE documentation team, about the way the docs repo (https://github.com/SUSE/doc-sle) 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 (https://github.com/openSUSE/doc-o-o). This is probably the best starting point for this team. _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 added. * 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 brainstorming. _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! Lana On 10/09/2020 14:52, Lana Brindley wrote:
Hi everyone,
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: https://t.me/opensuse_docs
Thanks for the great discussion, can't wait to chat more next week!
Lana
-- Lana Brindley @Loquacities 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@opensuse.org To contact the owner, e-mail: opensuse-doc+owner@opensuse.org
Hello, unfortunately I'm too busy to contribute to the documentation, but I can at least answer a question: Am Freitag, 18. September 2020, 07:51:45 CEST schrieb Lana Brindley:
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 added.
The current www.opensuse.org is managed at https://github.com/openSUSE/landing-page The page was initially created by Cyntia, the more recent changes were (IIRC) done by Doug and Stasiek (and several translators). Anyway - pull requests are always welcome ;-) Note that the repo also includes the rendered HTML, so you'll need to do the rendering (as described in the README) before you commit everything to git and open a PR. [1] Since I used the word "current", you might expect a new/future page, and we indeed have one: https://github.com/openSUSE/www-o-o (accessible as www-test.opensuse.org). This page was started by Stasiek and is still in its early stages. Regards, Christian Boltz [1] I know that this isn't optimal, but a) it was the only sane way we could use on the previous server and b) it probably doesn't make much sense to "fix" this issue while there is already ongoing work on a new page done. --
Leider Gottes ist es so, daß wenn man einen Spammer zu Strecke gebracht hat, dafür drei neue auftauchen. Das ist wie bei den Fliegen. Schlägst Du eine Tot, kommen 40 zur Beerdigung. ;) [> Martin Mewes und Michael Raab in suse-linux] -- To unsubscribe, e-mail: opensuse-doc+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-doc+owner@opensuse.org
participants (2)
-
Christian Boltz
-
Lana Brindley