Documentation

Documentation Guild maintains the wiki, signage and other NB info. We don't know how Noisebridge works either, but we'll write it down anyways WHEN: Participates in refreshing wiki whenever and during meetings and Doocratic Thursday hack sessions 5-9PM via the Jitsi. HOW: Create an account on the Wiki and participate in channels to discuss. CHANNELS: #wiki-and-docs-wg on Diacord. MAINTAINERS: Lxpk, Elan, Justin CURRENT PROJECTS: Wiki overhaul, NoiseFacts 2.0, NoiseManual print version,

Making Noisebridge Less Cryptic

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.

Things we do

• Wiki - working on improving the wiki. Look here for details on using and improving our Wiki tags, templates, categories, naming conventions, CSS, etc.
  • Manual - The Great Big Book of Noisebridge And How It Doesn't Fall Apart
  • Phong
  • Sidebar menu
  • Category:Pages_maintained_by_the_Documentation_Working_Group - The important things that are usually kept up to date
• Non-Wiki Activities
• Collect mail from the Mailbox
• Scan Documents
• Note-taking and tidying sometimes messed up notes formats
• Signage
• Transparency
• Ratchet
• WorkingGroup:Documentation/Discussion - Whenever someone wants it
• Teaching Noisebridgers
  • Enculturate others into producing Good Documentation
  • Train hackers in the ways of Good Documentation
• MetaGuild assistance to other Guilds
  • Recruiting more active Documenters to preserve maintenance continuity and resiliency
  • Asking de-facto event organizers and resource maintainers if they consent to being listed on the Wiki as such
  • Mentioning at meetings what guilds are recruiting more maintainers to help everything reach 2-5 maintainers.
  • Ask for Photo Wanted pages.

Special Wiki pages to find things to fix

• Special:SpecialPages
• Browsing Special:OrphanedPages and linking to them somewhere in the wiki

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:

• User:Lxpk (Made the nav menu templates and tries to help guilds)
• User:Elan (Knows a LOT about advanced MediaWiki tech)
• User:Mcint (Learned lots, on this wiki! templating, extensions, spam)
• User:Justinmorrison Cleanup, Copywriting, Usability, MediaWiki Maintenance
• User:Nthmost (making up for lost time in the scriptorium)
• You!?

Previous Active Documenters

The Wiki is a collaborative work of numerous Noisebridgers and these fine Documenters helped organize it.

• User:Tdfischer
• User:Patrickod
• User:Frank

Collaboration

• We talk about reducing the bus factor of Noisebridge.
• #wiki-and-docs-wg on Discord
• Probably some sort of regular gathering of documentation hackers?
• Maybe even a monthly wiki sprint!

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.)

• Phone Bell - An upstairs door bell using an old Stromberg Carlson phone.

• Phone Booth
• Infra Meetup Projects

Broken

Projects that need love to get working again.

• Kiosks
• Blog
• Website
• Signage

Unfinished

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

Upcoming Meeting

• 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:

{{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.

History

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

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