We switched from DocBook to ASCIIDoc and Antora a while ago. Don't worry
though, it's fairly easy to pick up. Here's some guides:
should be enough in pretty much all cases
- this goes way more in depth
The link to our contributor docs Eduard sent you earlier is also helpful
since it deals with some specifics of our publication system (Antora).
I'm currently working on massively improving that doc set, but what we
currently have should at least get you started. Also check the README in
the template repo for a crash course on how each repo works and how to
build a local preview: https://pagure.io/fedora-docs/template
For some easy tasks, we could use some reviewers for quick-docs.
Quick-docs are a set of former, popular Wiki pages that didn't really
belong on the Wiki but into user documentation instead, so they were
migrated to our docs site. The published version is here:
In the repository (which you'll find if you click Edit this page in the
top right corner) there are a couple pages that aren't yet published;
there are instructions on the index page:
. You don't need
to fix all of them, any effort helps.
On top of that we're also looking for people who can review content of
most of the quick-docs pages for technical accuracy - some of them are
pretty old and might be outdated. The ones that need a review have a
banner on top indicating they need a review, for example here:
. Check the
README (linked in the banner) for instructions on fixing that.
Other than that, in roughly a month F31 beta will be released and we'll
start writing release notes; those great for a newcomer since it's a
series of small, relatively simple tasks. I'll send a mail with
instructions to this list when it's time to get started - according to
the current schedule
) this should be on
September 17 or September 24.
You can also go through the docs repositories (
) and check their open
issues, you might find something that you'd like to fix. Be careful
though, not all of those repos are published on the site, so check for
that first - one day I'll clean that mess up :). You could even go check
some of the docs we publish but that are maintained by other teams like
the Council, Fesco, the Packaging Committee, etc., those aren't listed
in the above link because they're in a different namespace, but you can
dig them out of the sitewide config here:
If you have any further questions (or if most of what I just said
doesn't make sense to you :), either ask on this list, or ping me on
FreeNode in #fedora-docs, nick pbokoc. I'm almost always online during
business hours in UTC+2, and sometimes during evenings.
On 8/13/19 11:12 AM, A Jenkins wrote:
I'm sorry I haven't made it to any of the meetings but I'd like to help.
I haven't used Gobby before but I have got a bit of experience using
Docbook (command-line tools).
I found https://fedoraproject.org/wiki/Docs_Project_content_tasks_for_new_contrib...
Can someone help me choose a task please?
docs mailing list -- docs(a)lists.fedoraproject.org
To unsubscribe send an email to docs-leave(a)lists.fedoraproject.org
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://email@example.com