Synfig Project Forum

Forums for Synfig Project
It is currently Mon Sep 15, 2014 1:02 am

All times are UTC - 4 hours [ DST ]




Post new topic Reply to topic  [ 192 posts ]  Go to page 1, 2, 3, 4, 5 ... 13  Next
Author Message
PostPosted: Sun Jan 06, 2013 1:56 pm 
Offline
Site Admin

Joined: Thu Jan 10, 2008 2:16 am
Posts: 931
Location: Russia
Hello everyone!

We are preparing the release of new version of Synfig. After a long discussion it was decided that many things will have different names in the new version. That means introducing the new terminology

Here's the list of changes:

* Duck -> Handle (edited on 12.01.2013)
* Curves Panel -> Graphs Panel
* Encapsulate -> Group (icon needs to be reworked: box or folder)
* Paste Canvas / Inline Canvas layer -> Group layer (icon needs to be reworked: same as above)
* Group -> Set (icon needs to be reworked)
* Add/remove from Group->Add/remove from Set (icon needs to be reworked)
* BLine -> Spline
* BLine Point -> Spline Point
* BLine Tool -> Spline Tool
* Params Panel -> Parameters Panel
* Children Panel -> Library Panel
* CPoint -> Color Stop

Now we need to update the documentation pages before release and that's why we are running that sprint.

We have revision approval enabled for the wiki. It means that no changes will be visible on the wiki until they will get approved by moderators. That allows us to safely rewrite documentation pages for the new terminology, but keep those changes hidden until the new version of Synfig will be released.

So, moderators should NOT approve revisions containing the new terminology until the release.

You can download the binary packages with the new terminology here:
http://download.tuxfamily.org/synfig/packages/binaries/

To organize our work on updating documentation we will use following workflow:

1. Select page to rewrite and assign it to yourself

* Go to http://wiki.synfig.org/wiki/Dev:Sprints ... erminology and see the list of pages pending for rewrite. Decide for yourself which page you will be working on. Please ignore the pages having some username (inside of "<" and ">" symbols) after the title - that means someone is already rewriting this page now.

* You need to mark the chosen page as assigned to you. Please edit the list of pending pages and add your username near the title, surrounded by "<" and ">" symbols. Example: http://wiki.synfig.org/wiki/index.php?t ... ldid=16615

2. Rewrite the page

* Open chosen page. Go to edit mode.

* Now you have to carefully rewrite the page by doing search operation and replacing the found terms with new ones. Please take your time to replace carefully and check if your modifications fit the cotext. Make sure to do search in case insensetive mode. The search requests:

** "duck" (replace to "handle")
** "bline" (replace with "spline")
** "cpoint" (replase with "color stop")
** "curves" (replace with "graphs", but only IF it's about "Curves Panel")
** "group" (replace to "set", but only IF the context is related with "Groups Panel" functionality)
** "params" (replace with "parameters" if it's about "Params Panel").
** "child" (replace "child" or "children" with "library" if it's about "Child Panel" or "Children Panel". Please don't confuse with "Children Lock")

* When all the terms above are replaced then you have to replace the next ones (please make sure that you have those replacements only after all termins in previous step are replaced):

** "encapsul" (replace "Encapsulated"/"Encapsulation"/etc with "Group")
** "paste" (replace mentions of "Paste Canvas" into "Group")
** "inlin" (replace mentions of "Inline Canvas" with "Group")

* Add the {{NewTerminology}} at the top of the page. We need that because it is possible that while we doing that sprint someone will add the new pages to the wiki. Surely the newly added page won't be listed at http://wiki.synfig.org/wiki/Dev:Sprints ... erminology and thus it won't be updated. But if we have all updated pages marked with {{NewTerminology}}, then after the sprint will be finished we can filter the pages and see if there are any pages we have skipped.

NOTE: Please add the {{NewTerminology}} even if page have no matching words to replace. That way it is marked as done.

* Please specify following summary for your revision: "Terminology Updated". That will allow approval moderators to identify your edit as related with new terminology.

* Preview your changes. Read the edited page from start to the end to ensure that it's readable smoothly with new terminology. Correct the mistakes if found.

* Save page.

Example of edited page: http://wiki.synfig.org/wiki/index.php?t ... ldid=16614

* If the page title contains any of the terms above to replace, then rename (move) page accordingly. Don't worry, moving page won't get effect until it will be approved.

3. Mark the page as rewritten

* Go to http://wiki.synfig.org/wiki/Dev:Sprints ... erminology and remove the page you have edited from the list. Example: http://wiki.synfig.org/wiki/index.php?t ... ldid=16616

* Now go back to step 1.

NOTE: I don't see the reason to rename image files for now. The filenames aren't visible anyway. And I believe they will be replaced when all screenshots will be updated, right?

EDIT 2013-02-05: If you willing to update images as well, then Carlos have a good advice:
Genete wrote:
Warning! Do not upload new versions of existing images. they are updated without revision!
Instead upload it with a different name. I'm adding the Synfig's version at the end:
Image_name_0.63.06.png

_________________
Morevna project:
Recently completed tasks: Demo released
Top priority tasks: Synfig Development, Website reorganization


Top
 Profile  
 
PostPosted: Sun Jan 06, 2013 9:10 pm 
Offline
Site Admin
User avatar

Joined: Sat Dec 01, 2007 6:26 am
Posts: 4780
Location: Spain
A tiny question:
Color point or Color Point?

As we are using American English (color) instead British English (colour) we should also take care of use center instead of centre

-G

_________________
Synfig needs your help!
Developers, packagers, bug testers, translators, artists, web developers, wiki writers... you can contribute! :D


Top
 Profile  
 
PostPosted: Sun Jan 06, 2013 10:20 pm 
Offline
User avatar

Joined: Sun Aug 16, 2009 12:09 pm
Posts: 233
Location: Belgium
Zelgadis wrote:
* Duck -> Control Point


Tiny question, as I come late in the discussions I guess it's settled already, but did you consider handle to replace duck? I use to like shorter words for common terms, and we all know ducks were pretty much everywhere... hence "handle" is shorter than "control point"... which I guess will quickly be abbreviated into something ugly for newbies, such as CP (go figure :/ )

hope this helps.
B.

_________________
- discovering, learning about and liking Synfig, open source animation software -
| feel free to browse my Synfig archive | running v0.64.1 on Ubuntu Trusty |


Top
 Profile  
 
PostPosted: Mon Jan 07, 2013 7:19 am 
Offline

Joined: Fri Apr 27, 2012 4:35 am
Posts: 716
Here we'llll go...

berteh wrote:
handle to replace duck

Even if i'ts what i have used (poignée) in the french doc instead of canard...
For me : "Control Point"

Idea : Could be a good work to inform a max of website's admin who host some synfig tuto about the renaming.
for example : http://www.linuceum.com/Desktop/animSynfig.php , contact : contactus (at) linuceum (dot) com
Maybe in SitesWhoPreserveSynfigDucks ?

see(:ya!

_________________
Code:
for each doc in [wiki] ;; if not doc.lang.your ;; then translate(doc, lang.your) ;;

--------<<<<<<<<<<Synfig documentation Getting started>>>>>>>>>>>>----------


Top
 Profile  
 
PostPosted: Thu Jan 10, 2013 12:33 pm 
Offline
Site Admin

Joined: Thu Jan 10, 2008 2:16 am
Posts: 931
Location: Russia
OK, the binary packages for testing are available now:
http://download.tuxfamily.org/synfig/packages/binaries/

Genete wrote:
A tiny question:
Color point or Color Point?

I guess you mean "Stop"instead of "Point". I prefer "Color Stop" over "Color stop". Likewise we have "Layers Panel".

berteh wrote:
Tiny question, as I come late in the discussions I guess it's settled already, but did you consider handle to replace duck?

We did considered "handle". The decision was made to use "control point" instead. Well.. After rewriting a few wiki pages ( (1) (2) - please use preview mode for viewing this pages ) I'm starting to think that maybe Handle would fit better. And Inkscape use handle word as well... So, I'm in doubts again. ^__^

_________________
Morevna project:
Recently completed tasks: Demo released
Top priority tasks: Synfig Development, Website reorganization


Top
 Profile  
 
PostPosted: Fri Jan 11, 2013 4:23 am 
Offline
User avatar

Joined: Fri Jul 01, 2011 6:14 am
Posts: 312
Location: Hungary
Zelgadis wrote:
So, I'm in doubts again. ^__^


I don't care what anyone else calls them: I'm going to carry on calling them ducks. :lol:

_________________
http://kecskebak.blogspot.com


Top
 Profile  
 
PostPosted: Fri Jan 11, 2013 4:32 am 
Offline
Site Admin
User avatar

Joined: Sat Dec 01, 2007 6:26 am
Posts: 4780
Location: Spain
Zelgadis wrote:
I guess you mean "Stop"instead of "Point". I prefer "Color Stop" over "Color stop". Likewise we have "Layers Panel".

Yes, right, Color Stop. I prefer Color Stop to Color stop.

Zelgadis wrote:
I'm starting to think that maybe Handle would fit better

I agree there. I prefer single words for important concepts especially when it would need additional when it is needed to refer to one of them in particular. For example refer to Radius Handle is shorter and easier to translate than Radius Control Point

-G

_________________
Synfig needs your help!
Developers, packagers, bug testers, translators, artists, web developers, wiki writers... you can contribute! :D


Top
 Profile  
 
PostPosted: Fri Jan 11, 2013 4:37 am 
Offline
Site Admin

Joined: Thu Jan 10, 2008 2:16 am
Posts: 931
Location: Russia
Genete wrote:
I agree there. I prefer single words for important concepts especially when it would need additional when it is needed to refer to one of them in particular. For example refer to Radius Handle is shorter and easier to translate than Radius Control Point

So, looks like infamous "dictator decision" should be corrected. :D

_________________
Morevna project:
Recently completed tasks: Demo released
Top priority tasks: Synfig Development, Website reorganization


Top
 Profile  
 
PostPosted: Fri Jan 11, 2013 12:21 pm 
Offline
User avatar

Joined: Wed Apr 07, 2010 7:01 am
Posts: 214
Location: Germany
Genete wrote:
So, looks like infamous "dictator decision" should be corrected. :D

Whoever the dictator has been... go for it.
We would otherwise end up with the "cp" abbreviation I guess.

_________________
Cheers
Oho
----------------------------------------------------------------
Synfig 0.63.05 - Ubuntu 12.4/64/german - Lenovo R61


Top
 Profile  
 
PostPosted: Fri Jan 11, 2013 2:28 pm 
Offline
Site Admin
User avatar

Joined: Sat Dec 01, 2007 6:26 am
Posts: 4780
Location: Spain
ohoservices wrote:
Genete wrote:
So, looks like infamous "dictator decision" should be corrected. :D

Whoever the dictator has been... go for it.
We would otherwise end up with the "cp" abbreviation I guess.

Wrong quote? :wink:
-G

_________________
Synfig needs your help!
Developers, packagers, bug testers, translators, artists, web developers, wiki writers... you can contribute! :D


Top
 Profile  
 
PostPosted: Fri Jan 11, 2013 2:37 pm 
Offline
Site Admin

Joined: Thu Jan 10, 2008 2:16 am
Posts: 931
Location: Russia
Jcome made the code changes and I'm rebuiding the packages now. ^__^

_________________
Morevna project:
Recently completed tasks: Demo released
Top priority tasks: Synfig Development, Website reorganization


Top
 Profile  
 
PostPosted: Fri Jan 11, 2013 11:29 pm 
Offline
Site Admin
User avatar

Joined: Sat Dec 01, 2007 7:23 pm
Posts: 988
Location: West Coast USA
DaveJ - I'm with you. They'll always be ducks to me.


Top
 Profile  
 
PostPosted: Sat Jan 12, 2013 6:18 am 
Offline

Joined: Fri Apr 27, 2012 4:35 am
Posts: 716
Hey guys, do you know this one ?
pixelgeek wrote:
They'll always be ducks to me.

I feel that some unofficial duck'inside patchs will be released

Z : devsnapshot r20130109 installed correctly. "waiting" new one.
Has my system is in french, it's very easy to found the new strings ;-)

see(:ya!

_________________
Code:
for each doc in [wiki] ;; if not doc.lang.your ;; then translate(doc, lang.your) ;;

--------<<<<<<<<<<Synfig documentation Getting started>>>>>>>>>>>>----------


Top
 Profile  
 
PostPosted: Sat Jan 12, 2013 7:31 am 
Offline
Site Admin

Joined: Thu Jan 10, 2008 2:16 am
Posts: 931
Location: Russia
The new packages are uploaded now:
http://download.tuxfamily.org/synfig/packages/binaries/

Top post updated.

_________________
Morevna project:
Recently completed tasks: Demo released
Top priority tasks: Synfig Development, Website reorganization


Top
 Profile  
 
PostPosted: Sat Jan 12, 2013 7:56 am 
Offline
User avatar

Joined: Wed Apr 07, 2010 7:01 am
Posts: 214
Location: Germany
wow, very fast again...

I'll be on a business trip for 10 days starting monday.
Will have access to Internet and hopefully some time to spend in the evenings.
(different time zone: GMT+5, then GMT+7, closer to pixelgeek :-) ).

I propose to do no wiki doc approvals before the release of the new version, from now on.
I'll announce this accordingly in the forum post about doc approval and in the writers' doc in the wiki.
Okay?

Cheers OHo.


Top
 Profile  
 
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 192 posts ]  Go to page 1, 2, 3, 4, 5 ... 13  Next

All times are UTC - 4 hours [ DST ]


Who is online

Users browsing this forum: Majestic-12 [Bot] and 1 guest


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
cron
Powered by phpBB® Forum Software © phpBB Group