I personally would also vote B, just imagine I am one of the end users, option B provides more information that I might need. Furthermore I also think try to state things in a positive way would also be helpful to the product. Reading the draft now.
On Wed, Mar 14, 2012 at 8:24 PM, Rob Weir <[email protected]> wrote: > Thanks, everyone, for the quite and useful feedback. I wouldn't say > there was a conclusive preference for either model, so that suggests > we keep on iterating. I did, however, note a pattern of comments > related to verbosity, so I took another pass over the draft FAQs and > tried to tighten them up a bit. Vigorous writing is concise, etc. > > You can see the latest draft here: > > > https://cwiki.apache.org/confluence/display/OOOUSERS/Brainstorming+on+FAQs+--+draft > > Regards, > > -Rob > > > On Wed, Mar 14, 2012 at 3:21 AM, <[email protected]> wrote: > > Rob Weir [[email protected]] kirjoitti: > >> > >> This question came up on the other thread. I'd be interested in > >> > >> knowing which style of FAQ you prefer: > >> > >> Example A: > >> > >> "Who is building Apache OpenOffice releases? > >> > >> * In common with other Apache projects, work on Apache OpenOffice is > >> performed by individual volunteers. > >> * Development is done a number of the original developers of > >> OpenOffice.org in addition to community volunteers and developers from > >> other projects derived from the OpenOffice codebase including IBM > >> Symphony." > >> > >> or Example B: > >> > >> "Who is developing Apache OpenOffice? > >> > >> Like any other Apache project, work on Apache OpenOffice is performed > >> by a diverse group of volunteers, from over a dozen countries. We > >> have participants who are brand new to the project as of last week. > >> We also have many old hands, who have been involved with OpenOffice > >> for a decade or more. These volunteers work on coding, testing, > >> documentation, websites, translations, marketing as well as other > >> functions. Some of our volunteers are listed here: > >> http://incubator.apache.org/openofficeorg/people.html. If you are > >> interested in helping develop the next great version of Apache > >> OpenOffice please take a look at our Getting Involved page > >> (http://incubator.apache.org/openofficeorg/get-involved.html)." > >> > >> > >> Another set: > >> > >> Example A: > >> > >> "Where can I get updates to the copy of OpenOffice.org that I am > running? > >> > >> * There have been no updates to OpenOffice.org binaries released > >> for users since Oracle stopped development and there will be no > >> patches to those earlier binary programs released. > >> * The project is currently preparing a new version of the code and > >> it will be available through the openoffice.org website. > >> * Once Apache OpenOffice v3.4 is released, the project recommends > >> you replace your OpenOffice.org installation with it. > >> * Again, there are developer versions available for testing > purposes." > >> > >> > >> and > >> > >> Example B: > >> > >> "Where can I get updates to the copy of OpenOffice.org that I am > running? > >> > >> * The latest release of OpenOffice.org is 3.3. If you have that then > >> you have the latest. If you would like to extend the capabilities of > >> your OpenOffice 3.3 you might take a look at the many compatible > >> extensions (http://extensions.services.openoffice.org/) and templates > >> (http://templates.services.openoffice.org/) that are available. > >> * We are currently preparing a new release, Apache OpenOffice 3.4. > >> When available, you can download it from the http://www.openoffice.org > >> website. If you want to be on a notification list for when Apache > >> OpenOffice 3.4 is available for download, you can send an email to > >> [email protected]." > >> > >> These two approaches, A and B, differ in tone, formality and > >> information level. Which do you think would be most useful to users > >> seeking answers to their questions? > >> > >> -Rob > >> > > Hello! > > Personally I don't like long story but bullet list with links if needed. > > But A ja B are mixed for that. > > > > Regards > > Risto >
