Re: [libreoffice-documentation] Documentation team as venture capitalists of human capital

2017-08-06 Thread Olivier Hallot
Hi Ilmari

Em 02/08/2017 09:14, Ilmari Lauhakangas escreveu:
> The recent influx of new doc team contributors and Kenneth's wiki work
> caused something to click in my brain. I started thinking about the
> specific role of quality tech documentation in attracting and retaining
> contributors.
> 
> I would like to establish an image of the documentation team as one of
> the highest providers of value to the project. We can express this idea
> with a simple formula: in FOSS projects contributors equal money. A
> documentation team that provides excellent copywriting and tech docs is
> equal to an investor. Contributors keep flowing in as long as the doc
> team is strong in this area.

Good documentation is an asset of the project and a invaluable companion
product of LO (IMHO).

> 
> Now for something concrete, based on feedback received recently. I would
> like you to take a look at the main LibO website
> https://www.libreoffice.org/
> In the menu bar, do you agree that "Events" should be exchanged with
> "Get involved" that is currently hiding as a submenu item under
> "Community"?

Makes sense. Precious page real state.

> Could the intention be conveyed better by changing "Get involved" to
> something else? "How can I help?" was proposed, but I think we need to
> be careful not to mislead people seeking help files (and consider
> translatability).
> 

yes.

> In the "Get involved" page itself
> http://www.libreoffice.org/community/get-involved/ should we have a
> short piece that sells the idea of contributing? Ie. make everything as
> explicit as possible instead of "here are our teams, you know the rest,
> right?". There could be a general bit to draw the visitor in and then
> the individual team entries could be finessed until they are at the
> absolute peak of comprehensibility.

What about a 30 sec video on each topic of the page?

> 
> I am able to edit the page contents and if something in the layout needs
> changing I can handle it with the admin.
> 

The liberOffice website contents changes should, IMHO, be in synch with
the Marketing group as well as with connections to the National
Languages projects.

-- 
Olivier Hallot
LibreOffice Documentation Coordinator
Comunidade LibreOffice
Rio de Janeiro - Brasil - Local Time: UTC-03:00
http://tdf.io/joinus

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Documentation team as venture capitalists of human capital

2017-08-03 Thread Ilmari Lauhakangas

Hi,

luckily, there is already a logo done by Eliane Domingos. Olivier put it 
on the wiki and I did some edits so it can be displayed in the browser: 
https://wiki.documentfoundation.org/File:BOTTON.svg


Ok, so far we have these proposed "Get involved" alternatives:

- "How can I help?"
- "Join us"

I will sync with the Marketing team, when we have something ready.

On 02.08.2017 23:38, Cathy Crumbley wrote:

Ilmari,

I love what you are saying about the image of the documentation and
hope that there a budget for developing a snazzy logo and T-shirts.

For "get involved", would "join us" be friendlier, or might people
think that it is a request for donations? (It could include both
donations and volunteering, I suppose).

It is inspiring that you are heading in such a positive, friend
direction.

On Wed, Aug 2, 2017 at 8:14 AM, Ilmari Lauhakangas
 wrote:


The recent influx of new doc team contributors and Kenneth's wiki
work caused something to click in my brain. I started thinking about
the specific role of quality tech documentation in attracting and
retaining contributors.

I would like to establish an image of the documentation team as one
of the highest providers of value to the project. We can express
this idea with a simple formula: in FOSS projects contributors equal
money. A documentation team that provides excellent copywriting and
tech docs is equal to an investor. Contributors keep flowing in as
long as the doc team is strong in this area.

Now for something concrete, based on feedback received recently. I
would like you to take a look at the main LibO website
https://www.libreoffice.org/
In the menu bar, do you agree that "Events" should be exchanged with
"Get involved" that is currently hiding as a submenu item under
"Community"?
Could the intention be conveyed better by changing "Get involved" to
something else? "How can I help?" was proposed, but I think we need
to be careful not to mislead people seeking help files (and consider
translatability).

In the "Get involved" page itself
http://www.libreoffice.org/community/get-involved/ [1] should we
have a short piece that sells the idea of contributing? Ie. make
everything as explicit as possible instead of "here are our teams,
you know the rest, right?". There could be a general bit to draw the
visitor in and then the individual team entries could be finessed
until they are at the absolute peak of comprehensibility.

I am able to edit the page contents and if something in the layout
needs changing I can handle it with the admin.

--
To unsubscribe e-mail to:
documentation+unsubscr...@global.libreoffice.org
Problems?


http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/

[2]
Posting guidelines + more:
http://wiki.documentfoundation.org/Netiquette [3]
List archive:
http://listarchives.libreoffice.org/global/documentation/ [4]
All messages sent to this list will be publicly archived and cannot
be deleted




Links:
--
[1] http://www.libreoffice.org/community/get-involved/
[2] 
http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/

[3] http://wiki.documentfoundation.org/Netiquette
[4] http://listarchives.libreoffice.org/global/documentation/


--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted