[Bf-docboard] Bf-docboard Digest, Vol 58, Issue 1
Ivan Paulos Tomé
greylica at msn.com
Tue Nov 3 12:33:23 CET 2009
Hi Luca, I completely agree that the 2.4x series have to remain ''untouched '' by 2.5 series.
This won't stop us from mainatining the Manual, we have few retouchs to do in 2.4x series,
and part of the manual or uncovered functionalities (Mainly for the BGE) hev to be covered
properly.
In the Next Months I will be finishing the User Manual for the 2.4x Series, I wan't to write some
pages for the 2.5, but until I finish My Job, I won't be comfortable starting one thing and
forgetting other at the middle.
I Like to maintain 2.4x, there are few problems easily solved with few retouches, some pages that
need to split and some others needing a recode.
* Edge and Face Tools, for example, 37 Kib Page that need to be splited in order
to separate Edge Tools and Face Tools ),
* Skinning page, needs a complete revamp, explaining other skinning techs.
* Some Images (screenshots) have to be polished. (Only Blender Internals have to appear...)
About the 2.5 templates, I have to disagree for now, If there is a command change, is better explain
it in the manual itself, I am always talking to Brazilians about the subsurf, in the User Manual (took from 2.32),
it's explained that the subsurf is in the editing context, now its a Modifier.
Let´s put a note !
{{Note|1=Note|2=In earlier Blender Versions, like the one explained in this page (e.g. version 2.32 )
the subsurf was a tool/modifier present in the {{Literal|Editing}} Context {{Shortcut|F9}}, but the
non destructive functionality of the subsurf itself let the programmers consider subsurf as a Modifier,
and then Subsurf has been moved to the Modifiers stack, please, refer to
[[Doc:Manual/Modifiers/Mesh/Subsurf|Subsurf]] in the Modifiers Stack }}
This will avoid confusion if the user is still using older versions of Blender because of old hardware/OSs.
I think that is the best solution.
Good Vibes friends !
Ivan Paulos Tomé.
Greylica.
> From: bf-docboard-request at blender.org
> Subject: Bf-docboard Digest, Vol 58, Issue 1
> To: bf-docboard at blender.org
> Date: Tue, 3 Nov 2009 12:00:01 +0100
>
> Send Bf-docboard mailing list submissions to
> bf-docboard at blender.org
>
> To subscribe or unsubscribe via the World Wide Web, visit
> http://lists.blender.org/mailman/listinfo/bf-docboard
> or, via email, send a message with subject or body 'help' to
> bf-docboard-request at blender.org
>
> You can reach the person managing the list at
> bf-docboard-owner at blender.org
>
> When replying, please edit your Subject line so it is more specific
> than "Re: Contents of Bf-docboard digest..."
>
>
> Today's Topics:
>
> 1. Blender 2.5 documentation first proposal (mindrones)
> 2. Re: Blender 2.5 documentation first proposal (Tom M)
> 3. Re: Blender 2.5 documentation first proposal (Ira Krakow)
>
>
> ----------------------------------------------------------------------
>
> Message: 1
> Date: Mon, 2 Nov 2009 13:24:13 +0000 (GMT)
> From: mindrones <mindrones at yahoo.it>
> Subject: [Bf-docboard] Blender 2.5 documentation first proposal
> To: bf-docboard at blender.org
> Message-ID: <280140.84565.qm at web28607.mail.ukl.yahoo.com>
> Content-Type: text/plain; charset=us-ascii
>
> Hello,
>
> I noticed that someone already started to document 2.5 features in the current Manual, so I feel it is the time to explain what is my proposal about 2.5 docs.
>
> VERSIONING
> -----------
>
> Basically I think 2.4x manual should remain untouched, and we should branch into a 2.5 Manual, letting people choose between the two manuals usign an appropriate banner in the wiki.
>
> There is a sandbox page for 2.5 here:
> http://wiki.blender.org/index.php/Meta:Sandbox/Doc:2.5/Manual
>
> As stated in the page itself, the plan is to use the sandbox to write down things and keep Doc:Manual for 2.4 until 2.5.1.
>
> When we feel it's time to show Meta:Sandbox/Doc:2.5/Manual to the public, we can COPY Doc:Manual/* to Doc:2.4x/Manual/* and COPY contents from Meta:Sandbox/Doc:2.5/Manual/* to Doc:Manual, so that we keep a 2.4 version of the manual
> Moving is not an option because it deletes old content and redirects in general.
>
> Same applies to all folders "below" Doc: (Doc:Reference/* Doc:Tutorials/* etc) and Extensions (Extensions:2.5/Py/Scripts/Catalog/*)
>
>
> When 2.5x will become 2.6 we basically won't do anything because 2.6 is the 2.5 stable if I get it correctly, so Doc:Manual will be 2.6 already.
>
> I'd like to hear some opinions about versioning different blender version too, like having Doc:2.5.1/Manual Doc:2.5.2/Manual and so on, see also shortcuts, below.
>
>
> WARNING BANNER
> ---------------
>
> I'm going to put a big warning in the wiki to explain this, if there are disagreement just let me know here or online.
>
>
> AUTOMATIC REFERENCE and SHORTCUTS
> ----------------------------------
>
> We're working with Campbell in order to have an automatic reference for buttons, panels, etc in order to let authors and editors in general to use contents from it.
>
> Also, I'll propose a new way to put shortcut in the text: I'd like to create a "command" template to be used like this
>
> {{command|2.5.1|parent}}
>
> shows
>
> {{shortcut|ctrl|P}}
>
> so that if for some reason the default parent command in 2.5.2 change to shift-ctrl-P we just change Template:Command so that:
>
> {{command|2.5.2|parent}}
>
> shows
>
> {{shortcut|shift|ctrl|P}}
>
> This commands would be updated automatic with a script.
>
> This way the whole 2.5.2 manual will change in a second at release time.
> I still have to elaborate on this though...
>
> SKIN UPDATE
> ------------
>
> - There are some broken things in it (i.e. footer for unlogged users)
> - Francesco Siddi (fsiddi) is working on some css and js to make things easier to navigate, we talked live at the conference, but help would be needed of course, I'll mail about these things in a separate mail when things will be more clear
> - Bastien (Mont29) has proposed a very big change to do to manage Glossary in a cool way, but as for now it is quite big and doens't work properly in all cases
> - later I'll propose some Quiz stuff to be added in pages
>
> ==> We need to discuss some design in order to find the appropriate js framework working for all the new stuff.
>
>
> I'll write more mails laters, but I'd like to discuss these things as a start :)
>
>
> Regards, Luca
>
>
>
>
>
>
> _____________
>
> http://www.mindrones.com
>
>
>
>
>
> ------------------------------
>
> Message: 2
> Date: Mon, 2 Nov 2009 15:39:33 +0100
> From: Tom M <letterrip at gmail.com>
> Subject: Re: [Bf-docboard] Blender 2.5 documentation first proposal
> To: Blender Documentation Project <bf-docboard at blender.org>
> Message-ID:
> <584fe5640911020639r2a12930fo734837bbf5394bf5 at mail.gmail.com>
> Content-Type: text/plain; charset=ISO-8859-1
>
> Sounds good to me,
>
> LetterRip
>
> On Mon, Nov 2, 2009 at 2:24 PM, mindrones <mindrones at yahoo.it> wrote:
>
> > VERSIONING
> > -----------
> >
> > Basically I think 2.4x manual should remain untouched, and we should branch into a 2.5 Manual, letting people choose between the two manuals usign an appropriate banner in the wiki.
>
>
> ------------------------------
>
> Message: 3
> Date: Mon, 2 Nov 2009 11:25:18 -0500
> From: Ira Krakow <ira.krakow at gmail.com>
> Subject: Re: [Bf-docboard] Blender 2.5 documentation first proposal
> To: Blender Documentation Project <bf-docboard at blender.org>
> Message-ID:
> <6813ab000911020825s6527aa2fv59f96e7ef3cc8198 at mail.gmail.com>
> Content-Type: text/plain; charset="iso-8859-1"
>
> Very sensible approach. We should not force users to move to 2.5 - a number
> of them won't anyway. We should preserve the option of staying in 2.4x.
> Also, since the UI is so vastly different in 2.5, trying to document both in
> one manual will clutter up the documentation and make it less clear for both
> 2.4x and 2.5 users.
>
>
>
> On Mon, Nov 2, 2009 at 9:39 AM, Tom M <letterrip at gmail.com> wrote:
>
> > Sounds good to me,
> >
> > LetterRip
> >
> > On Mon, Nov 2, 2009 at 2:24 PM, mindrones <mindrones at yahoo.it> wrote:
> >
> > > VERSIONING
> > > -----------
> > >
> > > Basically I think 2.4x manual should remain untouched, and we should
> > branch into a 2.5 Manual, letting people choose between the two manuals
> > usign an appropriate banner in the wiki.
> > _______________________________________________
> > Bf-docboard mailing list
> > Bf-docboard at blender.org
> > http://lists.blender.org/mailman/listinfo/bf-docboard
> >
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL: http://lists.blender.org/pipermail/bf-docboard/attachments/20091102/a42645ed/attachment.html
>
> ------------------------------
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>
>
> End of Bf-docboard Digest, Vol 58, Issue 1
> ******************************************
_________________________________________________________________
Keep your friends updated—even when you’re not signed in.
http://www.microsoft.com/middleeast/windows/windowslive/see-it-in-action/social-network-basics.aspx?ocid=PID23461::T:WLMTAGL:ON:WL:en-xm:SI_SB_5:092010
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.blender.org/pipermail/bf-docboard/attachments/20091103/4e9e7ca5/attachment.htm
More information about the Bf-docboard
mailing list