#85 [Hackfest/FAD] Documentation writing and hacking session
Closed: Talk Scheduled 6 years ago Opened 6 years ago by rkratky.

  1. What is your proposal?

    Let's pick up where previous docs hackfests and activity days left off:

    • Docs content: we'll work on improving quick docs, adding new user stories, converting wiki pages into docs, modularizing existing docs, and fixing mistakes in language, format, and mark-up. We can also tackle translations if foreign-language speakers show up.

    • Docs tooling & web: we'll work to improve the publishing backend, support for localization, and Pagure workflow (incl. CI/CD). Hand-in-hand with that, we can work on improving docs presentation through navigation and page styling.

  2. Who needs to be in the room for this to succeed?

    No one specific person needed, but the following would be of help if available:

    • Adam Šamalík (asamalik)
    • Brian Exelbierd (bexelbie)
    • any member of the Fedora Documentation Team

  3. This is a

    • FAD/Hackfest that lasts a half-day, or
    • FAD/Hackfest that lasts a full-day (preference for full-day)

  4. Anything else we need to know?

    Room with tables for people to work on.

  5. Who are you?

    • Name: Robert Kratky
    • FAS ID: rkratky
    • IRC nick: rkratky

I would definitely like to attend part of this session if selected for Flock. Specifically from the CommOps side of things, I'd like to use this as a chance to get feedback from some Docs Team folks on a docs hackathon targeted at Fedora support communities.

Also, is this session open for sub-projects or teams that want to migrate from the wiki and get started writing in Fedora Documentation? There are also some other teams that want to do this already, perhaps this could be a good opportunity for them to get on board.

> Also, is this session open for sub-projects or teams that want to migrate from the wiki and get started writing in Fedora Documentation?

Everyone interested in improving Fedora docs is invited. Contributors and PRs are always welcome. In fact, one of the main ideas behind user story-based docs and modularization is to make it easier for uninitiated people to get up-to-speed quickly and contribute.

Metadata Update from @bex:
- Issue tagged with: Talk Accepted

6 years ago

Metadata Update from @bex:
- Issue close_status updated to: Talk Scheduled
- Issue status updated to: Closed (was: Open)

6 years ago

Log in to comment on this ticket.

Metadata