Hello everyone! Thank you to those who submitted their ideas for Hackweek projects in Gitlab :)  Tomorrow's All Hands meeting is devoted to Hackweek project proposal presentations.  So, those who submitted a Hackweek project proposal and *plan to work on those projects during Hackweek*, please be prepared to present the proposal tomorrow (Nov. 1st) during the All Hands meeting.  You'll have 5 minutes max to present. See you all at the All Hands meeting! Best, Tyler P.S. Gaba moved user documentation guidelines (that Gus wrote this year) into a wiki page on Gitlab. It's good practice to attempt to follow those guidelines as much as possible :) https://gitlab.torproject.org/tpo/team/-/wikis/Tor-User-Documentation-Style-... On 10/24/2023 3:13 PM, Tyler Corn wrote:

Hi everyone 🙂

More friendly reminders about Hackweek (happening Nov 6th - 9th):

(1) Like Pavel mentioned, don't forget to add your Hackweek project proposal to the issue queue in Gitlab this week (see Rhatto's Aug. 30 email below);

(2) If you don't have a Hackweek documentation project proposal, you can join someone else's proposed project;

(3) Next week's All Hands Meeting (November 1st) - (after the Finance Update) each Hackweek project proposer will have about 5 minutes to present their submitted project and everyone will have a chance to ask questions; and

(4) Project proposers - be thinking about where your group will be meeting (BBB room?) during Hackweek (on Nov. 6th) and what time folks will start working on the projects.

Thanks everyone!

Best, Tyler

On 8/30/2023 11:13 AM, rhatto wrote:

Hi!

The Tor Project and Tor community is going to be gathering online from November 6th to November 9th this year for a 4 days hackweek.

## About

This is a call for projects for whoever wants to participate, put together a team and hack through one working week with us. In the context of this hackweek, a project is anything related to Tor documentation that you can work with other people in 4 days. It could be improving the documentation for a project, a tutorial or could also be a cartoon, a screencast or anything that do not necessary requires coding skills. You will work on this project during 4 days with other people in your team.

This is an opportunity to discuss how documentation is working or not in your projects, as well as thinking, proposing, researching and testing solutions. Documentation is very important for any free software project as it is the way for people to start understanding the work we are doing, the way they can use our tools and start contributing with it.

In the next All-Hands following the Hackweek we are going to have a demo in a Big Blue Button's room where your team will present the work you did through the hackweek.

## Timeline

This will be the timeline for the hackweek this year:

* Until Monday, November 6th:     * Send hackweek project proposals to this issue queue: https://gitlab.torproject.org/tpo/community/hackweek/-/issues       (please use the "Proposal" issue template for the ticket       Description).

    * Before hackweek begins, start looking for other people to join       your team.

    * In order to join a proposal you liked, subscribe yourself to it's       ticket.

* Wednesday, November 1st - 16:00 UTC: All-Hands session prior to the   Hackweek were people/teams will present their project proposals for   other people to join their team if they want to.

* Monday, November 6th: Hackweek begins. People start working on   whatever they want related to documentation. By this time, you should   have a few members of your team already identified.

  Hack hack hack hack... in whatever way you organize yourself. We will   have the room #tor in irc.oftc.net to discuss general hackweek things.

* Thursday, November 9th: Hackweek ends.

* Wednesday, November 15th - 16:00 UTC: Each team presents the work they   did in the All-Hands session happening after the Hackweek.

## Projects

The updated list of projects will be available at https://gitlab.torproject.org/tpo/community/hackweek/-/issues. Each project can have one pad (you can usehttps://pad.riseup.net) and also use it's ticket to add all information that people need to add themselves to that project.

## References

For best practices on documentation, we recommend the following material:

* Diátaxis, "The Grand Unified Theory of Documentation": https://diataxis.fr/ * How to pick up a project with an audit: https://bluesock.org/~willkg/blog/dev/auditing_projects.html

cheers,

-- Silvio Rhatto pronouns he/him