organize hackweek on documentation

added Icebox label

changed due date to March 21, 2023

removed due date

changed due date to May 08, 2023

removed Icebox label

added Next label

removed due date

Applications team's best week for this hackweek is mid-July!

Gaba (@gaba):

Gaba commented:

Applications team's best week for this hackweek is mid-July!

If that's week 28 (7/10-7/16) then sounds good to me! I'd hope not week 29 as I'd be on vacation then (which is a good thing by itself, but...).

It turns out the week 28 is PETS and there is a few people from Tor attending it (the whole anti-censorship team). I will look for other date.

added Doing label and removed Next label

added Next label and removed Doing label

added Doing label and removed Next label

Week 34 from August 21st to August 25th seems to be the best candidate so far.

Gaba (@gaba):

Gaba commented: #115 (comment 2910626)

Week 33 from August 14th to August 18th seems to be the best candidate so far.

There will be a bunch of people at CCCamp2023 during that time (at least 7 or 8).

Yes. This is complicated. I changed the comment to have it the next week.

Still people on ccccamp. The last week of August would be the best.

assigned to @gaba

The first meeting to organize this hack week will be on June 27th at 14UTC.

@tyler @rhatto @anarcat and me organizing this hackweek.

changed due date to June 27, 2023

added Next label

removed Doing label

closed

moved to tpo/community/hackweek#2 (closed)

marked this issue as related to #190 (moved)

Some ideas

Dumping some ideas about structural changes that improves the overall documentation ecosystem:

• Onion MkDocs:
  • Provide support for people/teams that want to convert their wikis to or have docs for their projects using Onion MkDocs.
  • Convert some GitLab wikis to GitLab pages using Onion MkDocs:
    • Overview: tpo/tpa/team#41119 (comment 2898441)
    • Candidates:
      • The Hackweek project itself: https://gitlab.torproject.org/tpo/community/hackweek
      • Onion Support Wiki: https://gitlab.torproject.org/tpo/onion-services/onion-support/
      • Tor Policies repository: tpo/community/policies#3 (closed)
  • Investigate how Onion MkDocs could be a TPA-RFC-38 wiki replacement (#40909) · TPA / TPA team (tpa rfc 38 new wiki service):
    • One approach would be to create a script that import content from some existing GitLab wikis into a single Onion MkDocs instance, to see how it would like to have a convergent "documentation integration" place. How it could be structured? Could it be easily searchable? What would be the best practices for this?
• Onion TeX Slim enhancements:
  • Dockerfile for local builds.
  • Test and improve the LaTeX templates.
  • Add more functionality (graphics etc).
  • Localization support, at least for the Markdown/Pandoc version.
  • Add Onion TeX Slim support in a slides/ or docs/slides folder.
• Onion Reveal:
  • Write a reveal.js compiler similar to Onion TeX Slim:
    • Makefile that traverses a folder looking for .md files.
    • Then builds the HTML slides using a pandoc reveal template.
    • With support for QR code generation.
    • With CI/CD for automation.
    • Related issues:
      • Make Tor training slides compatible with Reveal JS format (#268) · community
    • Examples:
      • Tor Project | Helping survivors of domestic violence
      • Files · main · The Tor Project / Web / community · GitLab
      • content/training/resources/helping-survivors/contents.lr · community
      • templates/slideshow.html · main · The Tor Project / Web / community
      • models/slideshow.ini · main · The Tor Project / Web / community
      • assets/static/revealjs/dist/theme/tor.css · community
      • Helping Survivors of Domestic Violence

marked this issue as related to tpo/community/hackweek#5 (closed)

mentioned in issue tpo/community/hackweek#12 (closed)