# CentOS Web Revamp 2022 This is a draft work plan for revamping the various websites used by CentOS. --- ## Stakeholders * **Shaun McCance:** Community Architect, Promo SIG, docs person * **Alain Reguera Delgado:** Artwork SIG --- ## Web Properties ### centos.org * Source: Markdown * Build: Jekyll * https://git.centos.org/centos/centos.org ### blog.centos.org * WordPress * Login tied to accounts, but access list is custom * Probably continue to be standalone ### wiki.centos.org * MoinMoin wiki ### sigs.centos.org * Source: Markdown * Build: MkDocs * Main git repo: ??? (Landing page might just be a static page) * SIG Guide: https://git.centos.org/centos/sig-guide/ * Hyperscale: ??? * Automotive: https://gitlab.com/CentOS/automotive/sig-docs/ * Kmods: https://gitlab.com/CentOS/kmods/docs ### docs.infra.centos.org * Source: Markdown * Build: MkDocs * https://git.centos.org/centos/centos-infra-docs * Same build system as sigs.centos.org, but standalone ### docs.centos.org * Source: AsciiDoc * Build: ??? * Stream Contrib Guide, Install Guide and Release Notes for CL 7&8 ### docs from RHEL * Source: AsciiDoc * Build: Bespoke build system using Asciidoctor * Possibly can't be integrated into a single site * https://gitlab.com/redhat/centos-stream/docs/enterprise-docs * https://redhat.gitlab.io/centos-stream/docs/enterprise-docs/ ### gitlab.com/CentOS * Mentioned because some planning content might be better migrated to GitLab wiki pages or issues. --- ## Problems --- ## Requirements Must have: * Static site hosted in git (Pagure or GitLab) * Automatically deployed by CI on commit * Ability to easily run preview builds locally * Access control with accounts system Nice to have: * Automatic preview build by CI on merge request * Translations (need some level of content tracking) * Read from multiple locations? Current SIG docs each in own repo. But maybe we can just have separate builds for subroots. * Build multiple source formats? Some docs are AsciiDoc. But maybe we can use two tools. * Ability to build or inject info from data files? Can probably be done as a preprocess. Lots of data on SIG contacts and calendars that goes out of date if duplicated in prose. --- ## Tasks/Timeline * audits * content plan * set up sites * hackfest??