From c1b7482dd935712d8b51da3738b42425526bd92e Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Aug 26 2020 23:56:24 +0000 Subject: New page: Design & UX entrypoint (part of #8) This commit creates a new page for designers who may want to contribute to the Fedora Documentation site theming and style. As @ferdnyc subtly demonstrated for us in fedora-docs/docs-fp-o#148, we do not do a great job of telling people where to take their bugs or new ideas for the Fedora Docs site user interface. This page is not great either but it is a start! My immediate use case is this gives me a link I can point people to who might be interested in helping with design tasks and issues. We can iterate and improve on this as we go. Part of #8. Signed-off-by: Justin W. Flory --- diff --git a/modules/contributing/nav.adoc b/modules/contributing/nav.adoc index 43aa010..ffd3157 100644 --- a/modules/contributing/nav.adoc +++ b/modules/contributing/nav.adoc @@ -1,9 +1,12 @@ * xref:index.adoc[Contributing] -** xref:prerequisites.adoc[Prerequisites] +** For writers: +*** xref:prerequisites.adoc[Prerequisites] //** xref:repo-structure.adoc[Repository Structure] -** xref:contributing-to-existing-docs.adoc[Contributing to Existing Documentation] -** xref:adding-new-docs.adoc[Adding New Documentation to the Site] -** xref:local-preview.adoc[Building a Local Preview] -//** xref:working-with-translations.adoc[Working with Translations] +*** xref:contributing-to-existing-docs.adoc[Contributing to Existing Documentation] +*** xref:adding-new-docs.adoc[Adding New Documentation to the Site] +*** xref:local-preview.adoc[Building a Local Preview] //** xref:markup.adoc[ASCIIDoc Markup] -** xref:git.adoc[Git for docs writers] +*** xref:git.adoc[Git for docs writers] +//** xref:working-with-translations.adoc[Working with Translations] +** For designers: +*** xref:design-ux.adoc[Design & UX] diff --git a/modules/contributing/pages/design-ux.adoc b/modules/contributing/pages/design-ux.adoc new file mode 100644 index 0000000..f0b13cf --- /dev/null +++ b/modules/contributing/pages/design-ux.adoc @@ -0,0 +1,10 @@ += Design & UX of docs.fedoraproject.org site +Fedora Documentation Team + +This page explains how to contribute to the Fedora Docs Team as a designer or user interface (U.I.) / user experience (U.X.) developer. + +https://pagure.io/fedora-docs/fedora-docs-ui[*fedora-docs-ui*]:: +Sources of a U.I. for the new `docs.fedoraproject.org` site. + +https://docs.antora.org/antora-ui-default/build-preview-ui/[*Build a UI Project for Local Preview*]:: +Official `antora.org` documentation on how to build a preview site using a custom U.I.