FUDCON Malaysia Docs Hackfest

[Joshua J Wulf]

On 04/20/2012 02:17 PM, Christopher R. Antila wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Hi:
>
> I won't be at the FUDCon Malaysia, but this sounds like a VERY GOOD
> IDEA!!!
>
> What about mass editing at future FUDCons? We have lots of Guides at
> various states of being out-dated, and we could really improve the
> state of the documentation simply by publishing all of what we already
> have.
I'll trial it at this FUDCON and if it's successful we can do it at 
future ones. A "book per FUDCON" would rock. The new tool* is all about 
breaking down large documentation projects into microtasks that can be 
completed in parallel, so it's a good use case.

The resulting doc will still require an editor, obviously; but it's a 
good way to harness the critical mass of a FUDCON.


What current or potential docs could do with the love this time round?

- Josh

* We're still looking for a name - suggestions welcome!
https://bugzilla.redhat.com/show_bug.cgi?id=789243


>
> Christopher.
>
> On 04/19/2012 08:03 PM, Joshua Wulf wrote:
>> I have an idea for an interesting technological and social
>> experiment around docs for the Malaysia FUDCON.
>>
>> We have a topic-based authoring tool that we're using to develop
>> documentation inside Red Hat at the moment, called Topika.
>>
>> Last year I sponsored an intern project to integrate it with FAS,
>> so it has a FAS authentication module.
>>
>> I can spin up an instance in OpenShift or EC2 with FAS auth, we can
>> choose a book that we'd like to see for Fedora, and one that
>> matches the prevalent area of interest / expertise of the attendees
>> of the FUDCON.
>>
>> Then I can design the topic map for the book.
>>
>> Then at the FUDCON we work with the organisers to make it a feature
>> of the FUDCON that we will crowdsource the book in the three days
>> of the FUDCON. Every attendee can log into the Topika instance with
>> their FAS account, and write one (1) topic, using the supplied
>> template.
>>
>> We'll rebuild the book every five minutes on a stage so that
>> attendees can view the progress.
>>
>> If it works, then it could a viable way to get a book per FUDCON.
>>
>> What do you think?
>>
>> - Josh
>>
>> ----- Original Message ----- From: "Joshua J Wulf"
>> <jwulf at redhat.com>  To: docs at lists.fedoraproject.org Sent: Thursday,
>> April 19, 2012 10:48:27 AM Subject: FUDCON Malaysia Docs Hackfest
>>
>> Hey, anyone in docs going to FUDCON in Malaysia?
>>
>> Anyone docs hackfest organised for it?
>>
>> - Josh
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.12 (GNU/Linux)
>
> iQEcBAEBAgAGBQJPkOM3AAoJEInCktGVqZ8VUK4H/0MCZphIYW7UT4gmXv4IlHTZ
> h2dlmd1X+3YxTLuWTa8pd59vEhCz0EetQCm6w49AFPhNUZIaXl6COXd8gfSMZNp3
> G+wlWT/Uf4uzFotIj6/oDKskOqmw2QPsyJg3GnZW9k8d87tTE4oivP9S6v0dnOo8
> uz+3auB7PF57zS6yZ3pUScZWFAB0xO7y108Eyy8m3rjydm5K9nubEwn5BxZv93J2
> 2mAqEsRPu6qivHYzLlKianSvZO1svg+PXSx35eQI1QUN4GlpWdTM01eUps2nn6D2
> wVspOHVdTeZDFkWPynnA9yzNxTAYygKV/dTRc8psninX3yA7+bEunHdNCxG4nFQ=
> =mnEX
> -----END PGP SIGNATURE-----