Re: apologies : comments [Sidra]

I'm not sure I've seen anyone asking for apologies, but I have seen a lot of requests for increased clarity and comprehensiveness. Is the AO3 code documented anywhere?

[parent entry] [link] [reply]

I'm not sure I've seen anyone asking for apologies

I haven't seen anyone asking for an apology either. This post was in response to the people who did apologize, not in response to anyone who might have asked for one.

I have seen a lot of requests for increased clarity and comprehensiveness

Skud's post is a wealth of useful constructive criticism and we'll get around to implementing as much of it as we can as soon as we can within the limitations and constraints that we work under. We set up the in-house volunteer system to help train people who don't know how to code. People who already know what they're doing can fork the code and submit pull requests. Which skud has already done. It's one of the main reasons we moved to github.

Is the AO3 code documented anywhere?

The AO3 code is documented in the code. It's not documented very well. If you don't want to wait for us to fix it and would like to fork it and improve its documentation yourself, please, feel free.

[link] [parent] [reply]

I'm sorry, I was referring to independent documentation, similar to (though obviously not as complex as) Java's documentation. Another option is to have both official FAQs/documentation and community-driven documentation, the way Ubuntu does.

I'm not currently capable of writing such documentation due to time constraints, but I do think, as someone who's interested in doing driveby coding, that the more you guys attempt to recruit casual, experienced coders, the better off you'll be. I'd be happy to talk with someone about working on documentation in the future, though, if I knew there was a place to put it, and what the plans for community documentation were/are. :)

(sorry about the borked reply - that's what I get for making comments during finals week)

[link] [parent] [reply]

Unfortunately, you're not alone in not having the time at the moment. I didn't add Technical Writers to the people who aren't crawling out of the woodwork offering to help, but I could have. I know we've had a number of attempts at it in the past, but sadly they all fell by the wayside because of lack of time.

[link] [parent] [reply]

Well, like I said, I'd be happy to make the time! But first I'd need to talk with people who'd tell me how/when my documentation would be published and utilized.

[link] [parent] [reply]

Sun	Mon	Tue	Wed	Thu	Fri	Sat
		1	2	3	4	5
6	7	8	9	10	11	12
13	14 1	15	16	17	18	19
20	21	22	23	24	25	26
27	28	29	30

Sidra

(no subject)

(no subject)

(no subject)

(no subject)

(no subject)

November