silverflight8: Barcode with silverflight8 on top and userid underneath (Barcode)
silver ([personal profile] silverflight8) wrote2011-01-30 10:35 pm

Editing documentation.

Mainly to avoid spamming denise on dw_docs. Things got more organized the more I typed. THINGS ARE LINKED LIKE EVERYWHERE BECAUSE OTHERWISE THIS WOULD BE WILDLY OUT OF HAND.


-what is an interaction menu? removed from all FAQs; more confusing than helpful.

-add "and" to age restrict FAQ: "...Discretion", "Is suitable..."

-extra tag in restriction filters FAQ (twice)

-(viewer discretion advised) etc labels look like page breaks instead of example

-expand on last sentence, restriction FAQ

-choosing user icon FAQ: what "view thumbnails"?

-wrt to different methods of doing x, check site schemes access method

-"If the entry security level is "private", nobody can see it or any of its comments but you." should be no comments (unless they're yours) on a private entry

-super-confusing for me when I tried first to link to other sites; didn't process that <user> is like <a> (a href="" alt="" title="", etc) clarify? (too much HTML knowledge?) rework writing?

-link to other users: using RTE, highlight "Account" - add image?

-cut FAQ: hiding spoilers ineffective because linking direct to entry will bring up everything anyway; only effective for scroll-by, get rid of example?

-client FAQ: miscategorization? tangentially related to entries, anyway.

-private entries FAQ: not sure about future one - post at reg. security, edit to less-secure later - check tomorrow

-private entries FAQ: is it possible to make all private at once, or like LJ's one security level -> another? for posterity: apparently yes. Although I do not have a paid/prem account so can't check.

-private entries FAQ: mention that it's possible to do by hand, downloadable clients? (clients - DW nomenclature?)

-RTE/HTML editor FAQ: should come earlier?

-Crossposting FAQ: remove Inksome ETA: Ask for suggestions in dw-docs.

-HTML allowed FAQ: what about <iframe>? or hold off until Youtube thing is solved? ETA: nevermind, SOLVED.

-HTML allowed FAQ: insert warning - external web service, please be wary, not DW, etc?

-DOOO FAQ: add mention of how to make sticky post

-Poll FAQ: (poll does not look like a word anymore) HTML formatting tags for this? (same as LJ?)
-


* How do I post an entry?
* How do I set age restriction filters on my journal or entry?
* How do I post an entry to a community that I administer or am a member of?
* How do I control who can read my entries?
* How can I choose which user icon to use?
* How can I set my mood, music, or location?
* How do I edit or delete an entry?
* How do I make a link to another Dreamwidth account?
* What is a cut? How can I hide part of my entry behind a cut?
* How do I make an entry sticky, so it's always at the top of my journal?
* What is a client? What clients can I use with Dreamwidth?
* How do I make all my posts private?
* What is the Rich Text Editor? What is the HTML Editor?
* How can I crosspost entries?
* Which journalling services can I crosspost to?
* What HTML can I use in my entry?
* How do I post an entry without it showing on my subscribers' reading pages? Why would I do this?
* How do I create a poll?
* How do I close or reopen a poll?
* What is Auto-Formatting?
* How can I email entries into my journal?
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

Re: How do I post an entry?

[staff profile] denise 2011-02-01 01:11 pm (UTC)(link)
Don't worry about using the right markup for links in FAQs or anything -- when you submit the "final version", whoever puts it on the site (me) will take care of that!

Oh, and one other small note:

Add another sentence: "You can learn about switching between the two editors here."

You probably already know this, but just in case: using 'here' as link text is a bad idea for accessibility, because people using some screenreaders/adaptive browsers have a function that can give them nothing but the links on the page (to cycle through and see if they want to open/read them, yadda) and being left with a bunch of out-of-context links labeled 'here' is frustrating. So, for something like this, you'd use something like "You can learn about switching between the two editors: <a href="link to FAQ">Title of FAQ</a>" or "To learn about switching between the two editors, see "<a href="link to FAQ">Title of FAQ</a>"".

Like I said, you probably already know that, since it's in the Manual of Style and you complimented that to me already (thank you for that, by the way! it made me Very Happy) but I'm just checking. :)

And wow, you guys are fast! And awesome, and this is exactly the kind of thing I'm looking for people to do.
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

Re: How do I post an entry?

[staff profile] denise 2011-02-02 06:09 am (UTC)(link)
Oh, sure. You don't even have to use the alt text there (most screenreaders won't read it), just as long as the link text is something meaningful describing what you're heading towards, you're good. "Switching between the two editors" would work just fine as link text.