ρ (rho) wrote in lj_userdoc,
ρ
rho
lj_userdoc

Further reading and other such stuff

I'm sure you all remember my entry from a few days ago where I suggested simplifying the language we use in the FAQs, and getting rid of inline parenthetical links from the FAQs and moving them to a "further reading" section at the end of the FAQ.

While I'm happy to say that this was a widely well received idea, a few of my more experienced docadmin colleagues raised a few concerns over the exact methodology I was propsing based on important factors such as not spamming this community and not flooding translators, and somewaht less important factors such as the retention of my sanity. So there's a new plan.

First off, the further reading part. We've decided that we aren't going to try to do this in one big swoop, where we specifically try to edit the FAQs to fit the new style,but we're rather going to switch over somewhat more gradually, changing over to this new style whenever we're editing a FAQ anyway.

As such, we'd like to encourage anyone who makes a FAQ suggestion to also include a rewritten version of the FAQ which is in keeping with the "further reading" style (for anyone who isn't sure what I mean by this style, there's an example here and another one here). I'd like to emphasise though that this is absolutely not required. It's just something that would make our lives easier. If you want to make a FAQ suggestion and don't have the time, inclination or anything else to rewrite the FAQ in new style then please do still make your suggestion anyway. Someone else can come along and further-readingify it, and if they don't then the docadmins can do so when they edit the FAQ. You also don't need to try to simplify the wording; we're working on that separately.

So onto that part. Rather than doing this as I originally suggested, it's going to be more of a "behind the scenes" sort of change, and is going to move slower. I'll potter through them at a rate of about 2 or 3 per day, and then post updates every week or two of what I've done, rather than what I'm planning on doing. This has several advantages. Firstly, it lets me work at my own pace, rather than trying to fit my pace around the community, and allows me to go bit by bit rather than in big chunks, which is often easier. It also means that translators don't get hit with a huge barrage of updates in one go which makes them hate us. Finally, it means that I don't spam this community with a million and one entries that make half of you defirend it and the other half want to stab me. aajwind and alsatia have also volunteered to help me with this, which will make my job easier.

Any questions?
Subscribe
  • Post a new comment

    Error

    Comments allowed for members only

    Anonymous comments are disabled in this journal

    default userpic

    Your reply will be screened

    Your IP address will be recorded 

  • 1 comment