[Bf-docboard] Blender Manual: Vision Statement

Fri Dec 8 19:20:30 CET 2017

Hi all,

It should be a credo/creed - it doesn't have to be accurate or even 
realistic. It's what we try to achieve (in a perfect world).
And about what makes the manual different from other source of info 
about B. The aim should be one condense sentence.

I generally like the current mission statement, but what about replacing 
the "you" with "readers".
It's an info for people who hopefully become contributors and not for 
the readers. Also the triple "to" should be addressed:

     "This manual aims to be a complete and concise source of 
information to help (the) readers (to) become familiar with the 
application."

About Ton's remarks:
The described target group is/should be only the core audience. (as 
already pointed out)
An age is only a codification of certain skills reached (by school edu.) 
with ~18: advanced math & physics and basic computer science.
Expecting basic 3D is contrary to the current situation. We explain the 
basics e.g. what an edge, face, or a keyframe is, but not 
advanced/expert topics.
The "internal (technical) design" would mean data-blocks, dependency 
graph? such topics are currently barely covert would be
only of interest for experts and add-on devs. That would be on the edge 
to code documentation.

Regards,
Tobias

Am 08.12.2017 um 12:19 schrieb Diego Borghetti:
> Unless we have a legal reason for it ?
>
> On Fri, Dec 8, 2017 at 11:18 AM, Diego Borghetti <bdiego at gmail.com> wrote:
>> The manual already have that:
>>
>> People from 18 years and older.
>> People who already understand the basics of 3D and/or know other 3D software.
>>
>> I would say just drop the line ("People from 18 years and older".)
>> If you don't want to drop the line, my question will be "why is for
>> people from 18 years and older" ?
>> It's a software manual for people using the software. You can ask for
>> some level of know, like you already do in the second line, and that
>> is fine.
>>
>> I don't really see a point for the 18 years and older.
>>
>> Just my two cents,
>> Diego
>>
>>
>>
>> On Fri, Dec 8, 2017 at 11:11 AM, Bastien Montagne <montagne29 at wanadoo.fr> wrote:
>>> Maybe we could use the word 'educated' here? AFAIK (granted, am not an
>>> native English speaker ;) ), it designates someone who has already reached a
>>> minimal level of knowledge on the topic…
>>>
>>> So something like that:
>>>
>>> Educated people, who already understand the basics of 3D and/or know other
>>> 3D software.
>>>
>>> Or:
>>>
>>> People educated on CG, who already understand the basics of 3D and/or know
>>> other 3D software.
>>>
>>> This removes any age target, while still implying that you've done your
>>> homework and are not a total beginner expecting for CG 101 content…
>>>
>>> Bastien
>>>
>>>
>>> Le 08/12/2017 à 11:58, ken a écrit :
>>>
>>> Rather than attempting to wrestle with an age range, why not instead speak
>>> in experiential terms such as, 'anyone who plays intelligent chess or can
>>> read and understand a road map can probably learn to use Blender."?  Do
>>> people build models anymore...?  if so, that would be an indicative skill.
>>> Can anyone suggest others, or others which are better and/or more suitable?
>>>
>>>
>>> On 12/08/2017 04:47 AM, Ton Roosendaal wrote:
>>>
>>> Hi,
>>>
>>> Can a native english writer provide a better sentence then? Here in NL we
>>> don't have such annotations when it comes to age.
>>> Just like for games, books or movies, a manual can have a target audience.
>>>
>>> Also - as a high school kid I loved to read technology books or novels meant
>>> for an adult audience. But I started with the stuff meant for kids first.
>>> How do you classify that?
>>>
>>> -Ton-
>>>
>>> --------------------------------------------------------
>>> Ton Roosendaal  -  ton at blender.org   -   www.blender.org
>>> Chairman Blender Foundation, Director Blender Institute
>>> Entrepotdok 57A, 1018 AD, Amsterdam, the Netherlands
>>>
>>> On 8 Dec 2017, at 10:13, ken <cousin at newcultures.com> wrote:
>>>
>>>
>>>
>>> On 12/08/2017 12:35 AM, Greg Zaal wrote:
>>>
>>> Is it really necessary to mention age? There are many serious and impressive
>>> blender users younger than 18. Implying "this manual is for people older
>>> than 18" has other connotations ;)
>>>
>>>
>>> Agreed.  And parents, teachers, and librarians and others are called upon to
>>> quickly categorize materials and many want to avoid controversy.
>>>
>>>
>>>
>>> On Thu, 7 Dec 2017 at 10:10 Campbell Barton <ideasman42 at gmail.com> wrote:
>>>> Hi, updated the page based on this text:
>>>> https://docs.blender.org/manual/en/dev/about/introduction.html
>>>>
>>>> On Mon, Dec 4, 2017 at 2:16 AM, Ton Roosendaal <ton at blender.org> wrote:
>>>>> Hi Aaron,
>>>>>
>>>>> Thanks for the proposal to clarify that.
>>>>> However, the line is for me too vague and can be interpretated as you
>>>>> wish.
>>>>> Especially the "to help you" is undefined.
>>>>>
>>>>> To me it is more like this:
>>>>>
>>>>> Target group:
>>>>> - people from 18 years and older
>>>>> - people who already understand the basics of 3D and/or know other 3D
>>>>> programs
>>>>>
>>>>> The manual has as a goal to provide:
>>>>> - Insight in Blender's way of working, its internal (technical) design -
>>>>> in
>>>>> order to understand options and tools.
>>>>> - detailed functional description of every feature, tool or option in
>>>>> Blender.
>>>>>
>>>>> Regards,
>>>>>
>>>>> -Ton-
>>>>>
>>>>> --------------------------------------------------------
>>>>> Ton Roosendaal  -  ton at blender.org   -   www.blender.org
>>>>> Chairman Blender Foundation, Director Blender Institute
>>>>> Entrepotdok 57A, 1018 AD, Amsterdam, the Netherlands
>>>>>
>>>>> On 1 Dec 2017, at 19:50, Aaron Carlisle <carlisle.b3d at gmail.com> wrote:
>>>>>
>>>>> Hi all,
>>>>>
>>>>> Something that has been raised to my attention recently is that the
>>>>> manual
>>>>> does not have
>>>>> one defining purpose. This has caused the manual to have different
>>>>> purposes
>>>>> and people
>>>>> having their own agendas. We do currently have a vision statement but it
>>>>> is
>>>>> not very good
>>>>> and should be expanded on farther:
>>>>>
>>>>> "This manual aims to be a complete and concise source of information
>>>>> to help you to become familiar with the application."
>>>>>
>>>>> https://docs.blender.org/manual/en/dev/about/introduction.html
>>>>>
>>>>> So, the purpose of this email is to reconsider the above statement and
>>>>> discuss things that
>>>>> should be changed and/or added.
>>>>>
>>>>> Thanks,
>>>>>
>>>>> Aaron Carlisle
>>>>>
>>>>> Picture taker | Bit cruncher | Pixel pusher | Document writer | Artist
>>>>> Project administrator for the Blender 3D Documentation Project
>>>>> _______________________________________________
>>>>> Bf-docboard mailing list
>>>>> Bf-docboard at blender.org
>>>>> https://lists.blender.org/mailman/listinfo/bf-docboard
>>>>>
>>>>>
>>>>>
>>>>> _______________________________________________
>>>>> Bf-docboard mailing list
>>>>> Bf-docboard at blender.org
>>>>> https://lists.blender.org/mailman/listinfo/bf-docboard
>>>>>
>>>>
>>>>
>>>> --
>>>> - Campbell
>>>> _______________________________________________
>>>> Bf-docboard mailing list
>>>> Bf-docboard at blender.org
>>>> https://lists.blender.org/mailman/listinfo/bf-docboard
>>>
>>>
>>> _______________________________________________
>>> Bf-docboard mailing list
>>> Bf-docboard at blender.org
>>> https://lists.blender.org/mailman/listinfo/bf-docboard
>>>
>>>
>>> _______________________________________________
>>> Bf-docboard mailing list
>>> Bf-docboard at blender.org
>>> https://lists.blender.org/mailman/listinfo/bf-docboard
>>>
>>>
>>>
>>>
>>> _______________________________________________
>>> Bf-docboard mailing list
>>> Bf-docboard at blender.org
>>> https://lists.blender.org/mailman/listinfo/bf-docboard
>>>
>>>
>>>
>>>
>>> _______________________________________________
>>> Bf-docboard mailing list
>>> Bf-docboard at blender.org
>>> https://lists.blender.org/mailman/listinfo/bf-docboard
>>>
>>>
>>>
>>> _______________________________________________
>>> Bf-docboard mailing list
>>> Bf-docboard at blender.org
>>> https://lists.blender.org/mailman/listinfo/bf-docboard
>>>
>>
>>
>> --
>> --
>>
>>                         Diego
>
>