Skip to content
Snippets Groups Projects

WebsiteMaintenance

Last edited by Alexander Færøy

= 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/ isa 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/ al/sarah 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/ al/sarah
Adding a new report About/Reports https://www.torproject.org/about/reports/ arma/bekeela
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/ gus

tb-manual.tpo

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

Related Tickets

[[TicketQuery(status=!closed,component=Tor Browser Manual,order=id,format=table,col=id|summary|status|owner|keywords|priority)]]

support.tpo

  • Who's responsible for reviewing content to ensure it doesn't get outdated? Gus (for now)
  • Should there be a checklist of community/documentation related steps to execute when a new tor or Tor Browser is released?

Related Tickets

[[TicketQuery(status=!closed,summary=support portal,order=id,format=table,col=id|summary|status|owner|keywords|priority)]]

== 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

Comments

    Please register or sign in to add a comment.