November 2020 - openSUSE Documentation

[opensuse-doc] Nov 27: Minutes
by Adrien Glauser 27 Nov '20

27 Nov '20

Hello, Please find the minutes at https://en.opensuse.org/Opensuse-docs/minutes-meeting-11-27. Thanks to everyone who participated to this and the previous meetings! Have a pleasant week-end, Adrien

1 0

[opensuse-doc] Meeting notice: Friday, Nov 27 at 6:30 pm UTC
by Adrien Glauser 24 Nov '20

24 Nov '20

Hello everyone, We're meeting this Friday, Nov 27 at 6:30 pm UTC to discuss and plan the first milestones of our work toward an improved openSUSE docs. Main topics will be: 1) contents priorities (documenting in view of the installation process vs the rest) 2) layering contents according to different audience 3) workflow with https://github.com/Nycticorax/openSUSE-docs-revamped The bigger picture, which won't be addressed in this meeting but might be useful to bear in mind: https://docs.google.com/document/d/ 1zERjqqQrWBAoM3B25BIQ4hvTFU_Y7S8L57bh-wb6ld4/ See you there! Adrien

1 0

[opensuse-doc] Meeting minutes 21-11-2020
by Attila Pinter 20 Nov '20

20 Nov '20

Was a great night for docs! Special thanks to Adrien for the heavy lifting and easing the decision making process with his research! Meeting minutes: ========================= Present: Ivo, Adrien, Attila What we discussed: ================== - Documentation platform: Based on Adrien's work and research - which is available here if you missed it: https://en.opensuse.org/Opensuse-docs/prep-meeting-11-20 - we've been able to settle on the documentation platform which will be: MkDocs. We reached this decision by following our previously set guidelines - can find it in Adrien's research - while keeping a low barrier of entry for contributors with a short learning curve. - Video team Past few days the Video team gained full access to their KVM server to start recording videos. Ivo will try and round up volunteers for the video team and reach out to communities for help with content creation and translation. Next steps to follow. ================== If you're interested in helping out with the openSUSE documentation or video content creation don't be shy and hit us up ;) -- Br, A.

1 0

[opensuse-doc] Next meeting 20112020
by Attila Pinter 20 Nov '20

20 Nov '20

Dear All, The next meeting will be held this week Friday (20 November, 2020) at 1800UTC at https://meet.opensuse.org/opensuse-docs. https://en.opensuse.org/Documentation:Meetings#Meeting_.236_.7C_20_November…. Do prepare for a discussion around the documentation platform. -- Br, A.

2 2

[opensuse-doc] opensuse-docs team sync message 20201117
by Attila Pinter 16 Nov '20

16 Nov '20

Dear All, This is just a quick update mail of the recent happenings. We were finally able to work out the network issues and get a KVM server running for the Video Team - Ivo -. The Video Team is still looking for volunteers who can help with creating the tutorial videos. Ivo is looking for the following: - a native English speaker for recording the audio for the content, - someone who is interested in learning the recording process from Ivo and help him with the recordings. With the network issues out of the way next is setting up the ELK for analyzing different openSUSE channels for common problems and setting our priorities right. -- Br, A.

1 0

[opensuse-doc] This ML has been migrated
by Lana Brindley 11 Nov '20

11 Nov '20

Hi everyone, You should have all received an email, but this is just confirming that our ML has been migrated, and the email address for this list has now changed (although apparently the old ones will continue working for now). Old email address: opensuse-doc(a)opensuse.org New email address: doc(a)lists.opensuse.org You will need to update your address book, and probably any filters. For details on the header changes, check https://en.opensuse.org/openSUSE:Mailing_Lists_Migration Lana -- Lana Brindley @Loquacities Technical Writer - SUSE Manager "The question is," said Alice, "whether you can make words mean so many different things."

1 0

[opensuse-doc] Meeting minutes 20201107
by Attila Pinter 06 Nov '20

06 Nov '20

Thank you all for your time and contribution! ========================= Present: Ivo, Tomas, Adrian, Quang, Attila What we discussed: ================== - Next steps on settling on a static page generator for docs We have the following list available for us to pick a solution from contributed by members of the doc team: - AsciiDoc/Adoc - Github Pages - Read the docs - MkDocs - Gitbook - Gatsby - VuePress - Docusaurus - Antora (uses Asciidoc/Adoc) - Dauxio - Sphinx - mdBook - BookStack - Doxgen - Hugo & Docsy We're aiming to settle on a decision within the next 1-2 weeks. If you're interested in participating in the decision making do sound your opinion and share your reasons for your preferred platform. Once we settle on this we can continue settling on a format and workflow utilized across the docs team. Just to clarify! If you're not comfortable to participate with your docs in any of the above listed option and/or you prefer to use something else and maintain your docs elsewhere, but would like your docs to make it to the unified platform just leave a link to your docs and we will include them with the source included. - Video team discussion: Ivo to establish a unique standard that would aid in differentiating/identifying our video contents. Simple, short, to-the-point materials. Ivo also offered to record our meetings for those who can't make it in a video/audio format. If you interested in listening/wathing us talking docs let us know here/Telegram/Matrix/Discord. ===================== Clarification points: ===================== - We're planning to set up an ELK instance to be able to collect issues across multiple channels of openSUSE such as Discord, Reddit, Telegram, basically the user focused channels. The purpose of the initiative is to have a better insight into reoccurring issues so we can prioritize our work and also to measure the success of the docs team. - The meetings are currently happening every two weeks at 1800UTC on Fridays. We can set meetings for 0600UTC again if needed/there is demand for it. - The "team sync mails" are happening weekly. If you don't see a mail on a given week that is because nothing happened/changed. -- Br, A. -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

1 0

[opensuse-doc] Next meeting 2020-11-06
by Attila Pinter 05 Nov '20

05 Nov '20

Dear All, Apologies for the super late update - second week on the job and already slipping - we have a meeting on November 6, Friday 1800 UTC. The details will be available here: https://en.opensuse.org/Documentation:Meetings Jitsi link: https://meet.opensuse.org/opensuse-docs Also there has been no "sync mail" as there is nothing really changed from last week. -- Br, A. -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org To contact the owner, e-mail: opensuse-doc+owner(a)opensuse.org

2 1