- ([personal profile] rho) wrote in [site community profile] dw_docs2009-04-30 11:44 am

Look ma! A FAQ!

Thanks to the hard work of the FAQ team, the FAQ is now at a stage that's close to "completion". I use the scare quotes deliberately, because it's not anywhere near completion, and there's still a whole lot that needs adding and what have you. What's there at this point is pretty stable though, so I'm saying that we've now reached FAQ 1.0.

If you have time, go take a look at the FAQ and comment here to let me know what you think. We've done our best to make the FAQ clear and easy to read and to navigate, and I'd be especially interested to know how you think we've done with that. I'd like to know what you think we've got right, and I'd also like to hear any constructive criticism you have on things that you think we've got wrong.

This is also the place to comment if you find any typos or factual inaccuracies in the FAQ. We've had at least two pairs of eyes looking over every FAQ to try to cut down on errors, but it's inevitable that some will have slipped in. If you find any, comment here, and we'll get them fixed when we get a chance.
ext_259: Animé-esque 'toon of a girl holding her flabby belly, with the name 7rin alongside the image (Default)

[identity profile] 7rin.livejournal.com 2009-04-30 02:09 pm (UTC)(link)
Looking good. I like how easily accessible it is.

Minor error found (really really minor): How do I unsubscribe from or revoke Access for another journal? (http://www.dreamwidth.org/support/faqbrowse.bml?faqid=75) The 'Manage Circle' link has the underlining of the link continue over into the space after 'circle'.

What!? I did say it was minor. :p
sollers: me in morris kit (Default)

Access lists/filters

[personal profile] sollers 2009-04-30 02:19 pm (UTC)(link)
I have now spent over five minutes hunting around in the FAQs and am unable to find out how to set up access filters. The best thing I could find was:

"When making a locked post, you can restrict its access to a subset of your access list."

I was unable to find anything at all on access lists.
sollers: me in morris kit (Default)

Re: Access lists/filters

[personal profile] sollers 2009-04-30 04:15 pm (UTC)(link)
Many thanks for the quick response!

But hey, this is the whole point of beta stages, isn't it?
snakeling: Statue of the Minoan Snake Goddess (Default)

Re: Access lists/filters

[personal profile] snakeling 2009-04-30 06:36 pm (UTC)(link)
Sorry, I struggled for ages with this one. I had to ask for the accessibility team's help because it was a nightmare to write using non-sighted language. It's now complete :)
ephemera: celtic knotwork style sitting fox (Default)

[personal profile] ephemera 2009-04-30 03:35 pm (UTC)(link)
do you want 'bigger than typos / less critical than missing sections' comments, that are more opinion than fact now, later, or not at all?

For example, I think http://www.dreamwidth.org/support/faqbrowse.bml?faqid=126 (Coming to DW from LJ: Naviagation bar) could usefully tell people coming to DW from LJ that the visibility of the nav bar is now something controlled by the logged in reader everywhere (with a link to the control tab for doing that)

- what's there isn't wrong or critically missing vital functions, and for all I know the faq writer went back and forth over that ten times already...
Edited 2009-04-30 15:57 (UTC)
ephemera: celtic knotwork style sitting fox (Default)

[personal profile] ephemera 2009-05-04 11:30 am (UTC)(link)


http://www.dreamwidth.org/support/faqbrowse.bml?faqid=5
Would it be worth adding a paragraph to mention email posting for paid users, and client software with links to relevant FAQ pages for those methods?

******

FAQ page for email posting, especially as the email command bit hasn't yet been LJ-stripped, and I know at least two people who assumed that that meant it didn't work yet.
http://bugs.dwscoalition.org/show_bug.cgi?id=721
http://www.dreamwidth.org/manage/emailpost.bml?mode=help&type=headers

******

http://www.dreamwidth.org/support/faqbrowse.bml?faqid=101&q=email
visible work-in-progress in the final paragraph, with a log in date of a week ago. Is this work in progress, or did it slip off someone's radar?

******

http://www.dreamwidth.org/support/faqbrowse.bml?faqid=33
"There will be a few instances where we won't be releasing our code; one is that we're keeping the code for our site scheme (the look and feel of the site) closed-source so it's unique to us. However, we want these exceptions to be few and far between and will provide our reasoning in all cases."

Suggestion - re-order the sentence so it's
"There will be a few instances where we won't be releasing our code. We want these exceptions to be few and far between and will provide our reasoning in all cases. For example, we're keeping the code for our site scheme (the look and feel of the site) closed-source so it's unique to us."

Suggestion 2 - regardless of sentence structure, where are they going to provide reasoning? Link to the community or FAQ section?

Suggestion 3 - is it just the default site scheme, all the colour shifts of Troposcopic, or all the site schemes? 'look and feel' is a bit vague.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 05:46 pm (UTC)(link)
If I may make a suggestion: I think FAQ#2 and FAQ#12 should link to FAQ#105 somehow. For FAQ#105 it could be part of "The Invite Code system is designed to let Dreamwidth grow slowly and sustainably". For #2 I have no idea, sorry. FAQ #105 is awesome BTW.
Edited 2009-04-30 17:46 (UTC)
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 05:59 pm (UTC)(link)
On http://www.dreamwidth.org/support/faqbrowse.bml?faqid=125:

Archive: This replaces "Calendar" on LiveJournal, but like the LiveJournal Calendar, the Dreamwidth Archive displays past entries of a journal or community by year or by month

The page is called 'calendar' but on many layouts, it's called 'archive', not calendar. DW makes the same distinction. In the journal URL it's 'calendar'. In menus it's 'archive'. Also, you can display past entries by day.

Profile: On LiveJournal, it's User Info, on Dreamwidth, it's your Profile.

It's User Profile/Community Profile/Syndicated Feed Profile on LJ too.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 06:09 pm (UTC)(link)
On http://www.dreamwidth.org/support/faqbrowse.bml?faqid=133

Minor issue: someone correct me if I'm wrong but some of these icons are not used (yet?). For example 'remove access' is 'modify access' and has got the same icon as 'grant access'.

Actually, lots of these 'Hey! You're from LJ?' FAQs would be useful in a Guide to Newbies, not just to LJ users. My apologies if it's already been suggested/discussed.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 07:10 pm (UTC)(link)
In http://www.dreamwidth.org/support/faqbrowse.bml?faqid=47:

You can set the comment security level for each individual entry when you post it. You can make an entry where comments are not allowed, even if you have commenting turned on in general. When you're posting an entry, change the Allow comments? setting to Disabled. If you have commenting turned off in your journal, you can't set one entry to allow comments.

This is a bit confusing because the first sentence doesn't apply in all cases so it looks like we're said contradictory things. What about going straight to the point?

If you have commenting turned on in general, even with restrictions, you can still make entries where comments are not allowed. When you're posting... However, if you have commenting completely turned off in your journal,...

Another suggestion: could FAQ titles when viewed via ?faqcat be turned into links to each individual FAQs?
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 07:18 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=58

You can ban someone by entering their account name on the Ban and Unban Accounts Page.

Lowercase p for page.

If you change your mind, you can use the Unban link on the same page to allow the person to comment again.

Assuming they mean the Ban and Unban Accounts page, there's no 'Unban link'. There are boxes you check and then a button to save your changes which says 'Ban and Unban Accounts'.
Edited 2009-04-30 19:19 (UTC)
forthwritten: stained glass spiral (Default)

[personal profile] forthwritten 2009-04-30 09:29 pm (UTC)(link)
Fixed.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 07:25 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=59

You can protect your entries so that either only people on your access list can read the entries, or so that only people on your list can comment, even though everyone can read.

I think this sentence should link to http://www.dreamwidth.org/support/faqbrowse.bml?faqid=54 and http://www.dreamwidth.org/support/faqbrowse.bml?faqid=9.

You can also remove them from your access list (if they're on it).

Link to http://www.dreamwidth.org/support/faqbrowse.bml?faqid=75?
forthwritten: stained glass spiral (Default)

[personal profile] forthwritten 2009-04-30 09:32 pm (UTC)(link)
Fixed.
forthwritten: stained glass spiral (Default)

[personal profile] forthwritten 2009-04-30 09:24 pm (UTC)(link)
Fixed.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 07:43 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=17

go to your "Manage Circle" page

The other FAQs don't use quotes when referencing page titles.

you may Enter the Dreamwidth account names or OpenID URLs of people you want to add to your Circle.

Lowercase e in enter, I think.

If the community administrator has chosen Moderated Membership when the community was created, you'll need to email the community's owner to be added to the community's membership list.

You can find out which type of community it is, or who to contact to be approved for membership if it's a Moderated Community, on the Community's Profile Page.

Aren't requests automatically e-mailed to the owners? It's what's said on http://www.dreamwidth.org/community/settings.bml. Are there any cases where that may not happen? Or was this actually meant for Closed communities?
Edited 2009-04-30 20:03 (UTC)
forthwritten: stained glass spiral (Default)

[personal profile] forthwritten 2009-04-30 10:28 pm (UTC)(link)
I've fixed the first two things you've mentioned and passed the rest on to someone who knows more about communities than I do.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 11:20 pm (UTC)(link)
In case this needs to be changed: http://www.dreamwidth.org/support/faqbrowse.bml?faqid=101 says With moderated membership, requests to join your community will be emailed to you for approval.
forthwritten: stained glass spiral (Default)

[personal profile] forthwritten 2009-05-01 12:46 am (UTC)(link)
Fixed.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 11:44 pm (UTC)(link)
And another related FAQ: http://www.dreamwidth.org/support/faqbrowse.bml?faqid=110

With moderated membership, users cannot join your community freely — they must request membership by attempting to join. You can choose to be notified by email when somebody tries to join your community, by selecting the appropriate option under "Administrative Options" on the Manage Communities page.
ninetydegrees: Art: floating cute creatures and hearts (cloud 9)

[personal profile] ninetydegrees 2009-05-01 01:02 am (UTC)(link)
Membershop → membership :) Also you rock.
forthwritten: stained glass spiral (Default)

[personal profile] forthwritten 2009-05-01 01:19 am (UTC)(link)
Hm, this is why editing FAQs at 2am is Bad - thanks for catching it :) I'll see what I or other members of the docs team can do about the rest of the FAQs. Your feedback is really helpful, thank you.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 07:46 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=18

If the community's Posting Access is set for Non-Members May Post

I think it's 'set to' instead of 'set for'.
ninetydegrees: Art: does and waterfall (dear deer)

Thank you!

[personal profile] ninetydegrees 2009-04-30 09:36 pm (UTC)(link)
Whee! You're like the fix-machine. Ok that was only mildly funny in my head. I think I need food...
forthwritten: stained glass spiral (Default)

Re: Thank you!

[personal profile] forthwritten 2009-04-30 10:06 pm (UTC)(link)
Well, having detailed feedback like this makes it much easier to fix things, so thank you very much for that!
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 09:54 pm (UTC)(link)
This just in. http://www.dreamwidth.org/support/faqbrowse.bml?faqid=4

Extra semi-colon in the table:

Number of icon slots:
forthwritten: stained glass spiral (Default)

[personal profile] forthwritten 2009-04-30 10:07 pm (UTC)(link)
Fixed.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 10:44 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=97

You can change the way the main site pages look with the Display tab of the Account Settings page.

From what I've seen on other FAQs it should be "in the Display section of the My Account Settings page".
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 10:53 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=136

Then go to the Display tab of the My Account Settings page

Section? I don't know if it consistently says section rather than tab. I haven't read all the FAQs.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 11:00 pm (UTC)(link)
Still for reference:

http://www.dreamwidth.org/support/faqbrowse.bml?faqid=67 and http://www.dreamwidth.org/support/faqbrowse.bml?faqid=70 say 'tab' too.

http://www.dreamwidth.org/support/faqbrowse.bml?faqid=96 says Account Settings page instead of My Account Settings page.
Edited 2009-04-30 23:21 (UTC)
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 10:52 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=120

Added "random community" page, as well as the existing "random user" page, to help you find interesting active communities.

Random community is a link but random user isn't. :/

annoyed us. for instance:

Missing capital F, I think, or the punctuation isn't right.
Edited 2009-04-30 23:22 (UTC)
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 11:11 pm (UTC)(link)
I think http://www.dreamwidth.org/support/faqbrowse.bml?faqid=27 or http://www.dreamwidth.org/support/faqbrowse.bml?faqid=116 should mention that you can check whether a feed already exists by entering its URL in the Add Feed box as it automatically links you to the subscribe page if it does. The risk is that people create duplicates if the URL is different but the same risk exists already anyway as you can't search feeds.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 11:19 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqcat=comm-manage

I think FAQs tend to mention how you can reach this page via the menus. These don't; they only provide a link.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 11:27 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=101

The 'Adult Content' section has editorial comments.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 11:43 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=109

When entries are submitted to the moderation queue, administrators will be notified with a link to the moderation queue

There should be a link to the queue/Manage Communities page. Besides, you can select not to get notified.

You can enable moderation for your community on the Manage Communities page.

Manage Communities should be a link.

Finally, this FAQ and http://www.dreamwidth.org/support/faqbrowse.bml?faqid=101 always say administrator and never say moderator. It's only casually mentioned in http://www.dreamwidth.org/support/faqbrowse.bml?faqid=110. Is this on purpose?
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-04-30 11:50 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=111

Banning a member from your community will remove their ability to post comments or entries to your community. This will not remove their community membership, though, so they will still be able to see any members-only entries.

To mimic what's said in 'Removing a User from your Community' it should be added that to prevent them from seeing members-only entries, they should be removed from the members list in addition to being banned. People may have not read the previous section. It also makes me wish for internal links linking the two sections together.
ninetydegrees: Art: self-portrait (Default)

[personal profile] ninetydegrees 2009-05-01 12:17 am (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=74

Er, links? Please?

http://www.dreamwidth.org/support/faqbrowse.bml?faqcat=rels

All these FAQs are pretty bare. How do I go to someone's profile. What's the Interactions Menu? Also I don't think the ways filters are explained is simple and clear. It feels different from the language used in the other FAQs.
turlough: young man in hideous green-patterned shirt with rised finger, Xander from 'Buffy the Vampire Slayer' ((buffy) excuse me?)

[personal profile] turlough 2009-04-30 07:31 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=123

Should there perhaps be mentioned that OpenID accounts can't become members of communities?
jamie: bitter panda saying not quite zen (Default)

[personal profile] jamie 2009-04-30 08:02 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=4

Needs to link to the page on the wiki that lists all the acct levels:
http://wiki.dwscoalition.org/notes/Account_levels

Suggest you add dates to the 'first six months' for people who don't track ambiguous time periods well (so Apr 30 to Oct 30, 2009), etc.
cesy: "Cesy" - An old-fashioned quill and ink (Default)

FAQ question

[personal profile] cesy 2009-04-30 08:39 pm (UTC)(link)
Is there a FAQ with a list of the features of paid accounts? Or an account type comparison?
forthwritten: stained glass spiral (Default)

Re: FAQ question

[personal profile] forthwritten 2009-04-30 10:08 pm (UTC)(link)
That's been included here.
kakashi: image of sleeping red sheep thinking about Dreamwidth while holding a Death Note (dw sheep- deathnote)

Mmm, Memories

[personal profile] kakashi 2009-04-30 08:46 pm (UTC)(link)
This is from the Memories FAQ.

In the second paragraph, the sentence says, "If you enter a blank description the entry will be deleted.". Instead of "the entry will be deleted" it should be "the memory will be deleted.".
Edited 2009-04-30 20:47 (UTC)
forthwritten: stained glass spiral (Default)

Re: Mmm, Memories

[personal profile] forthwritten 2009-04-30 10:09 pm (UTC)(link)
Fixed.
zvi: self-portrait: short, fat, black dyke in bunny slippers (Default)

[personal profile] zvi 2009-04-30 08:59 pm (UTC)(link)
http://www.dreamwidth.org/support/faqbrowse.bml?faqid=133 None of these icons have alt text. :(
Edited 2009-04-30 21:01 (UTC)
ivorygates: (Default)

[personal profile] ivorygates 2009-05-01 12:18 am (UTC)(link)
What the alt text would say in this case would be the exact same thing the line of text beside the icons says, since this is the FAQ where the new icons are labeled and defined. Since this is so, should these icons be alt-texted, or should we add a note at the top of the FAQ making this clear?

Thanks.
zvi: self-portrait: short, fat, black dyke in bunny slippers (Default)

[personal profile] zvi 2009-05-01 04:02 am (UTC)(link)
Either way would work; might want to ask someone who actually uses a screenreader what makes the most sense to them.