wiki:org/meetings/2019Stockholm/Notes/WebsiteMaintenance

Long Term Workflows to Maintain Website and Portals

Facilitators: hiro, pili

What do we need to do in order to ensure the new website and portals don't descend into chaos?

Some of the pages in the new website and portals are likely to need regular updating. The aim of this session is to make a list of these pages/sections and try to find owners to take care of updating them. We will also discuss the necessary workflow for suggesting changes, editing the page, reviewing and merging. One of the requirements for this workflow should be that ideally updaters don't necessarily need a lot of technical knowledge to do so.

Please join us if you're interested in taking on a section of the new website or you're just interested in how this works.

Other discussion topics will include:

  • cleaning and reviewing stylesheets
  • upgrading to bootstrap 4.3.1
  • documentation to allow frontends/copywriters/translators to collaborate

Prep

  1. List of pages that are updated often or list of actions that are done on existing pages, e.g adding a new Tor Browser version, adding a new person to the people page, etc...
  2. Is there any existing owner for making updates to this page?
  3. Is there any documentation currently describing how to update this page?

Rough Agenda:

  • Overview of Lektor
    • plans
    • improvements
  • Review different websites and tasks and find owners
  • Review open tickets and find owners/close
  • Discuss potential workflows for keeping portals up to date
    • how to contribute
    • how to make the process more agile
      • What should be the process for updating?
        • PR, review, merge?
        • Owners for each of these responsibilities
  • Service Maintenance
    • Scheduling upgrades
  • "Design" Maintenance
    • Stylesheets review and clean up
  • Documentation to foster collaboration and volunteer input

tpo

Action Page(s) Link(s) Owner Documentation
Adding a new Browser release Various https://www.torproject.org/download/ https://www.torproject.org/download/alpha/ boklm?
Adding a new Tor Browser Language Tor Browser Language Download Page https://www.torproject.org/download/languages/ emmapeel? https://dip.torproject.org/web/tpo/wikis/How-to-develop-on-the-website#tor-browser
Adding a new tor release Download Tor https://www.torproject.org/download/tor/ nickm? https://dip.torproject.org/web/tpo/wikis/How-to-develop-on-the-website#tor
Updating People Page About/People https://www.torproject.org/about/people/ https://dip.torproject.org/web/tpo/wikis/How-to-develop-on-the-website#how-to-add-a-new-tor-person
Updating Sponsors About/Sponsors https://www.torproject.org/about/sponsors/ https://dip.torproject.org/web/tpo/wikis/How-to-develop-on-the-website#how-to-add-a-new-sponsor
Moving a Sponsor from "Active" to "Past" About/Sponsors https://www.torproject.org/about/sponsors/
Adding a new report About/Reports https://www.torproject.org/about/reports/ arma?/sue?
Updating the jobs page About/Jobs https://www.torproject.org/about/jobs/ erin?
Adding a new Press Release Press https://www.torproject.org/press/ stephw?
Adding Press Coverage Press https://www.torproject.org/press/ stephw?
Adding a new language for website translation Whole site - emmapeel?

community.tpo

Action Page(s) Link(s) Owner Documentation
Adding/Updating a new training resource Training Resources https://community.torproject.org/training/resources/ gus?
Updating Current Status of Translations Current Status of Translations https://community.torproject.org/localization/current-status/ emmapeel?
Updating Outreach Materials Street Team Kit https://community.torproject.org/outreach/kit/ antonela?
Updating Speaking Resources Talk about Tor https://community.torproject.org/outreach/talk/ stephw
Updating Good/Bad ISPs Good Bad ISPs https://community.torproject.org/relay-operations/community-resources/good-bad-isps/ relay operators

tb-manual.tpo

  • Who's responsible for updating when new features are added

Related Tickets

Ticket Summary Status Owner Keywords Priority
#13005 Please document Tor Browser environment variables needs_review traumschule faq Medium
#20537 Tor Browser User Manual needs meta section accepted Jaruga Medium
#20538 TB manual single page assigned t0mmy Medium
#23922 The Uninstalling page does not mention the TorBrowser-Data directory on OSX needs_review traumschule Medium
#25198 User manual should explain Tor Browser features more assigned wayward Medium
#28235 Generate screenshots for the Tor Browser manual assigned arthuredelstein Medium
#28489 tb-manual: add moat as a way to get bridges needs_review phoul moat Medium
#28490 tb-manual/secure connections: fancy svg is not working, needs to be fixed or replaced assigned wayward Medium
#28516 tb-manual: add alt attributes to the images for accessibility new phoul Medium
#28557 tb-manual: review and update the known issues page assigned wayward Medium
#28820 Tor Browser Manual: Add Android specific details new phoul Medium
#29584 Write a guide to understanding a Tor log assigned wayward Medium
#29856 tb manual: duplicated info around bridges assigned ggus documentation, tbb Medium
#30161 tb-manual: sidebar does not move to the other side when on ltr languages new phoul Medium
#30297 Add links to threat-assessment documents at tb-manual.torproject.org/security-settings assigned emmapeel Medium
#30844 Update Tor Browser Manual with "NoOnionTraffic" option new wayward Medium
#30966 Install instructions for Linux/Ubuntu users who might not be entirely familiar with tar.xz new wayward Medium
#31060 Default obfs3 bridges are gone in Tor Browser assigned ggus Medium

support.tpo

  • Who's responsible for reviewing content to ensure it doesn't get outdated
  • Should there be a checklist of community/documentation related steps to fulfil when a new tor or Tor Browser release

Related Tickets

Ticket Summary Status Owner Keywords Priority
#22179 Website redesign/Support portal: Instructions - Setting up a mirror assigned Medium
#27119 Usability Testing: Support Portal assigned antonela ux-team Medium
#27562 Detect the locale and automatically serve the language specific support portal new hiro Medium
#29502 Glossary on the support portal should be moved to the main menu new hiro Medium
#30080 support portal: keep anchor when changing language assigned hiro Medium

Resources

Meeting Notes

  • We need to come up with a workflow so that Steph can edit the portal
  • What do we need to document for new people of various skill levels?
    • Branching in gitlab
  • Steph can be involved with support, tpo and community
    • She could be a reviewer
  • Steph can own tpo.org/press
    • How can she update this?
    • Anto needs to confirm about the idea with press releases
    • Separate from blog post
      • Can make it a page
      • Can link outside
      • Like a pdf or a blog post, but don't want it to be in the main feed.
    • ACTION: We need to design what a press release should look like
      • How would it work?
      • Documentation for creating one in lektor
      -Coverage
      • Steph wants to take ownership of Coverage
      • Action: Document what to edit to do this
  • Gus will own training resources
    • relay operators
  • Community, support and torproject
    • need a simple way to edit this page?
    • github
    • ACTION: Guides to update
Last modified 5 weeks ago Last modified on Jul 16, 2019, 10:10:24 AM