Documentation: Difference between revisions

From Noisebridge
Jump to navigation Jump to search
(Created page with "{|style="background-color:#000;color:#f00;font-weight:bold;border:5px solid #f00;text-align:center;margin:auto;font-size:3em;line-height:1em;font-family:monospace;" |- |Docume...")
 
(21 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{MetaGuild}}
{|style="background-color:#000;color:#f00;font-weight:bold;border:5px solid #f00;text-align:center;margin:auto;font-size:3em;line-height:1em;font-family:monospace;"
{|style="background-color:#000;color:#f00;font-weight:bold;border:5px solid #f00;text-align:center;margin:auto;font-size:3em;line-height:1em;font-family:monospace;"
|-
|-
Line 10: Line 11:
How does Noisebridge work? That is a damn fine question, but who really knows, eh?
How does Noisebridge work? That is a damn fine question, but who really knows, eh?


= Projects =
The purpose of the Documentation Working Group is to '''encourage and maintain the documentation of noisebridge'''.
 
'''The first meeting of the Documentation WG is Thursday, September 18th, 2014 at 7 PM'''
 
= Things we do =


* [[Manual]] - The Great Big Book of Noisebridge And How It Doesn't Fall Apart
* [[Manual]] - The Great Big Book of Noisebridge And How It Doesn't Fall Apart
* [[Phong]]
* [[MediaWiki:Sidebar|Sidebar menu]]
* [[:Category:Pages_maintained_by_the_Documentation_Working_Group]] - The important things that are usually kept up to date
* [[:Category:Pages_maintained_by_the_Documentation_Working_Group]] - The important things that are usually kept up to date
* Collect mail from the [[Mailbox]]
* Scan [[Documents]]
* Enculturate others into producing Good Documentation
* Train hackers in the ways of Good Documentation
* Browsing [[Special:Orphaned pages]] and linking to them somewhere in the wiki
* [[Note-taking]]
* [[Special:SpecialPages]]
* [[Signage]]
* [[Transparency]]
* [[Ratchet]]
* [[WorkingGroup:Documentation/Discussion]] - Whenever someone wants it


= Folks =
= Folks =
 
Collaboration by all interested parties present and future is key here; '''not''' power-seeking control!<br>
We the underhacked have pledged to contribute to the never-ending task of scribbling down things about Noisebridge:
We the underhacked have pledged to contribute to the never-ending task of scribbling down things about Noisebridge:


* [[User:Tdfischer]]
* [[User:Tdfischer]]
* [[User:Patrickod]]
* [[User:Lxpk]]
* [[User:Frank]]
* '''You!?'''
* '''You!?'''
= Collaboration =
* #docs-wg on [[Slack]]
* Probably some sort of regular gathering of documentation hackers?
* Maybe even a monthly wiki sprint!
<div style="font-size:20px">We're the documentation working group! We meet during Philosophy talks bimonthly to talk about reducing the [https://en.wikipedia.org/wiki/Bus_factor bus factor] of Noisebridge.</div>
== Projects ==
* [[Signage]] is ongoing. Make/Suggest signs that should exist or changes to improve them.
* [[Labels]] need to go directly on everything, whereas the sign may go next to it with more info.
* [[Promotion]] group creates updated bulletins about things happening at the space and promotes them to the outside world.
=== In Progress ===
* [[Hackstations]] (Kiosk enclosures for major tools/activity areas with attendant pegboard for attaching relevant bookshelves/supplies relevant and [[Signage]] elevated above it to make it easy to find with instructions for use.)
=== Broken ===
Projects that need love to get working again.
* [[Kiosks]]
=== Unfinished ===
* [[NoiseFacts]] is an idea for a small printed version of the manual for new arrivals.
=== Upcoming Meeting ===
We are going to have another meeting soon to discuss printing/lasercutting/constructing kiosks for [[Signage]], wiki docs, etc.
* [[Documentation Working Group Next Meeting]]
== Meeting Notes ==
We meet sometimes. Here are some meeting notes
* [[Documentation_Working_Group_09-25-14]]
== Taking care of our projects ==
Every wiki page that Docsbridge works on needs to be tagged with the following template:
<pre>
{{DocsWG}}
</pre>
This will ensure that it has the following notice at the bottom and that we can keep tabs on these pages and keep them in good working order.




{{DocsWG}}
{{DocsWG}}

Revision as of 00:37, 1 July 2020

Noisebridge | About | Visit | 272 | Manual | Contact | Guilds | Resources | Events | Projects | 5MoF | Meetings | Donate | (Edit)
Guilds | Meta | Code | Electronics | Fabrication | Games | Sewing | Music | AI | Neuro | Philosophy | Funding | Art | Security | Ham | Brew | (Edit)
MetaGuild | Recruiting Guilds | Volunteer | Documentation | Outreach | Working Groups | CommunityWorkingGroup | Badges | (Edit)
Documentation Working Group
We don't know how Noisebridge works, but we'll write it down anyways

Noisebridge is cryptic at times. Most of the time, actually.

How does Noisebridge work? That is a damn fine question, but who really knows, eh?

The purpose of the Documentation Working Group is to encourage and maintain the documentation of noisebridge.

The first meeting of the Documentation WG is Thursday, September 18th, 2014 at 7 PM

Things we do

Folks

Collaboration by all interested parties present and future is key here; not power-seeking control!
We the underhacked have pledged to contribute to the never-ending task of scribbling down things about Noisebridge:

Collaboration

  • #docs-wg on Slack
  • Probably some sort of regular gathering of documentation hackers?
  • Maybe even a monthly wiki sprint!
We're the documentation working group! We meet during Philosophy talks bimonthly to talk about reducing the bus factor of Noisebridge.

Projects

  • Signage is ongoing. Make/Suggest signs that should exist or changes to improve them.
  • Labels need to go directly on everything, whereas the sign may go next to it with more info.
  • Promotion group creates updated bulletins about things happening at the space and promotes them to the outside world.

In Progress

  • Hackstations (Kiosk enclosures for major tools/activity areas with attendant pegboard for attaching relevant bookshelves/supplies relevant and Signage elevated above it to make it easy to find with instructions for use.)

Broken

Projects that need love to get working again.

Unfinished

  • NoiseFacts is an idea for a small printed version of the manual for new arrivals.

Upcoming Meeting

We are going to have another meeting soon to discuss printing/lasercutting/constructing kiosks for Signage, wiki docs, etc.

Meeting Notes

We meet sometimes. Here are some meeting notes

Taking care of our projects

Every wiki page that Docsbridge works on needs to be tagged with the following template:

{{DocsWG}}

This will ensure that it has the following notice at the bottom and that we can keep tabs on these pages and keep them in good working order.


This page is maintained by the Documentation Working Group. If technical writing is your thing, you should consider helping out by editing this page! | Document ALL The Things! YES, ALL THE THINGS | Edit