From b28576f6484ca96f835900d4dd8c4596c6c9bf81 Mon Sep 17 00:00:00 2001 From: lilyx Date: Aug 04 2021 07:16:28 +0000 Subject: updated fedora websites docs landing page 1st draft --- diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc index 443a076..32818b5 100644 --- a/modules/ROOT/pages/index.adoc +++ b/modules/ROOT/pages/index.adoc @@ -2,18 +2,88 @@ Rick Elrod; Ryan Lerch :page-authors: {author}, {author_2} -The Fedora Websites project owns and maintains the Project's online presence. -Among other things, the team: - -* Works closely with the - link:++https://fedoraproject.org/wiki/Design++[Fedora Design team] to build - our websites in a way that is visually pleasing, easy to use, accessible to - everybody, and provides a good experience for newcomers and existing users - and contributors alike. -* Works closely with the - link:++https://fedoraproject.org/wiki/L10N++[Fedora Translations team] to - ensure that websites are able to be translated into different languages. -* Maintains the content of the websites, updating it as necessary for releases, - new editions, new spins, and so on. +== Who We Are +The Fedora Websites & Apps team works on the frontend and backend of Fedora's websites and web applications. +This team is a reboot of the previous Fedora Website's team, created by community members to update and improve Fedora's web presence and online documentation. + +We are a growing team of developers with a range of skills and interests. One of our team's first goals is to set up the foundation of an empowering mentorship program. + +== Our Collaborations +Working on both websites and web applications, our team is regularly communicating and working with different stakeholders in Fedora's community. +* We work closely with the link:++https://fedoraproject.org/wiki/Design++[Fedora Design team] to build our websites that are visually pleasing, easy to use, and accessible to everybody. +* Along with the design team, we also work closely with link:++https://fedoraproject.org/wiki/Infrastructure++[Fedora Infrastructure] on backend technologies. +* We also collaborate with the link:++https://fedoraproject.org/wiki/L10N++[Fedora Translations team] to ensure that websites are able to be translated into different languages. * Typically has one member (either in Design or Websites) who sits on the xref:mindshare::index.adoc[Fedora Mindshare committee]. + +== What We Do +The W&A Team updates and maintains the code bases for Fedora's websites and web applications. We collaborate closely with the Fedora Design team and Fedora Infrastructure to implement new designs and update backend code. The W&A team is regularly working on a variety of tasks that are suitable for new and experienced contributors. + +=== Tasks Include: +* Adding temporary content to websites +* Coding design mockups provided by the Design Team +* Updating server side code +* Improving language and accessiblity support +* Revamping websites to improve user experience +* Writing documentation for contributors + +=== The Web and Apps Team Revamp +In 2021, the Fedora Websites Team began a revamp into the Fedora Websites & Apps Team. This was was started in order to facilitate the growing interest in Fedora's web presence as well as a need for a knowledgeable group of contributors to focus on keeping Fedora's websites and apps up to date current with modern web standards. + +== How To Get Involved + +To get involved with the Fedora W&A team get in touch with us through the email list or by messaging us on Telegram. We are looking for both front and backend contributors of all skill levels. If you are interested in getting active, feel free to check out the open tickets on pagure. + +We also welcome new contributors to our weekly meetings. If you have something that you would like to address, send a message to one of our team leads ahead of time so that we can plan to discuss your topic at an upcomming session. + +=== Membership + +In order to beceme member of the Fedora Website & Apps Team, Applicant must be register to link:++https://accounts.fedoraproject.org++[Fedora Accounts] and set up an account with the link:++https://pagure.io++[Pagure] gitforge. + +By becoming a Fedora Contributor, you accept these terms. + +* link:++https://fedoraproject.org/wiki/Legal:Fedora_Project_Contributor_Agreement++[Fedora Project Contributor Agrement (FPCA)] +* link:++https://docs.fedoraproject.org/en-US/project/code-of-conduct/[Code of Conduct] + +=== Are You New to Web Development? +We flag tickets that are suitable for new contributors and those whom are newer to html, css, js, and python. If you aren't sure where to start, or cannot find documentation that you are looking for, get in touch with one of our team members and they will help point you in the right direction. + +One of the goals of our revamp is to offer mentorship to those who are new to the field, or just interested in advancing their skills. If you are interested in mentorship, get in touch with one of our admins and they will help connect you with someone for mentorship opportunities. + +=== Are you an experienced Web Developer? +We often have tickets that demand more advanced knowledge of the technologies in our stack, and as web development is such a fast moving field, we are always interested to work with developers that bring something new to the table. Do you see something that you would like to work on? Please get in touch with us. + +== Meetings +We hold weekly meetings to review tickets and other tasks, touch base on direction, check in with one another, discuss team direction, and plan activities. Feel free to join us and get involved or to come and ask any questions that you have. We are a diverse team that is always looking for new contributors. + +* Location: link:++https://meet.jit.si/fedora-websites-apps-meeting++[Jitsi Room] +* Day: Tuesdays +* Time: 15:00 - 16:00 UTC + +=== Communication Channels +The W&A Team has a couple different lines of communication. Get in touch with us in any of the following ways: +* Telegram _TBA_ +* [Discussion Forum](https://discussion.fedoraproject.org/c/project/websites/66): Public Discussion Space +* [Email List](https://lists.fedoraproject.org/archives/list/websites@lists.fedoraproject.org/): Announcements, new member introductions + +== Resources +The W&A Team is made up of people who work on all levels of the tech stack. We value perspectives and experience from all positions of the tech stack. Check out these resources for your own setup. We are always working to expand our instructional material and documentation. + +=== Fedora's Website Tech Stacks +* Fedora Community Blog: Wordpress +* Fedora Websites: Flask, Jinja, HTML, CSS3, JavaScript, Python 3 +* Fedora Docs: Asciidoc + +=== Documentation +* link:++https://pagure.io/design/issue/raw/files/8eab7011bae8219d61f810698b9e18a2b4ea84bb856a3f63f090aa986c4f3923-The_Fedora_Project_-_Logic_Model_for_Websites__Apps_Objective.png?raw=1++[Fedora Websites Revamp Logic Model]: An overview of the Websites Team revamp +* link:++https://developer.fedoraproject.org/tech/languages/python/python-installation.html++[Fedora Developer Python] +* link:++https://developer.fedoraproject.org/tech/languages/python/flask-installation.html++[Fedora Developer Flask] +* For those interested in php and working with the link:++https://communityblog.fedoraproject.org/[Fedora Community Blog] +* link:++https://fedoramagazine.org/howto-install-wordpress-fedora/++[Wordpress Local Setup Instructions]: This article will help you setup a local wordpress deployment on Fedora. + +== Code Repositories +* link:++https://pagure.io/fedora-websites++[Fedora Websites] +* link:++https://pagure.io/fedora-web/websites/++[Fedora Main Website] +* link:++https://github.com/fedora-infra/fedbadges++[Fedora Badges] +* link:++(https://github.com/fedora-infra/noggin++[Fedora Account System(FAS)] +* link:++https://pagure.io/fedora-docs/docs-fp-o++[Fedora Docs]