Updating Organization Chart

Discussions about the wiki documentation of FreeCAD and its translation.
drei
Posts: 479
Joined: Sun May 11, 2014 7:47 pm
Location: Mexico
Contact:

Updating Organization Chart

Postby drei » Sun Mar 15, 2015 6:47 pm

Just stumbled upon the Organization_chart and found out it hasn't been updated since 2013. Would it be useful to update it? If yes, please reply with the updates that you would like to see.

Example
Reply:
  • Add XYZ to modules, user: xyz
  • Add language: A language, user: translator
  • Remove section ???, because: Reason
Currently I'm trying out a new scheme with the wikitable template, you can check it out here Drei_sandbox. I fused it all into one big table and added visible lines to separate each element. Not sure if it's pleasing to the eye.

Like always, any input is greatly appreciated.

Regards,
Isaac
Need help? Feel free to ask, but please read the guidelines first
User avatar
Yinameah
Posts: 43
Joined: Tue Feb 10, 2015 2:00 pm
Location: Sierre, Wallis, Switzerland

Re: Updating Organization Chart

Postby Yinameah » Fri Mar 20, 2015 12:51 am

Hello,

Here is my modest feedback :

I find you proposition already much more readable. The old one is really ugly IMHO.

But I think it's still difficult to read. I think the different section (such as "Module", "File Format") should have thicker separation line or a gap between the section.
I also think it's not so clear at first glance which box is the title and which is the users. Some typo/color/underline policy should help here, maybe using {{Properties_Title|*Title*}} or something like that ?
ian.rees
Posts: 696
Joined: Sun Jun 15, 2014 3:28 am
Contact:

Re: Updating Organization Chart

Postby ian.rees » Fri Mar 20, 2015 2:17 am

Interesting find, drei, and I second Yinameah's feedback. -Ian-
drei
Posts: 479
Joined: Sun May 11, 2014 7:47 pm
Location: Mexico
Contact:

Re: Updating Organization Chart

Postby drei » Fri Mar 20, 2015 4:31 am

Thanks for the feedback, I'll get to play with the template during the weekend and see what I can come up with, my plan is to make the template parametric, in a way that we can easily add new people or sections to the table and have it adjust automatically (perhaps it's not possible, but one can always dream).
Need help? Feel free to ask, but please read the guidelines first
User avatar
r-frank
Posts: 2181
Joined: Thu Jan 24, 2013 6:26 pm
Location: Möckmühl, Germany
Contact:

Re: Updating Organization Chart

Postby r-frank » Fri Mar 20, 2015 6:34 am

Okay, also my 2 Cents ...

I am used to read organization Charts like flow charts formerly done with Visio or similar, nowadays done with DIA or something similar.

Perhaps you could use a table-like presentation ?

Roland
Deutsche FreeCAD Tutorials auf Youtube
My GrabCAD FreeCAD-Projects
FreeCAD lessons for beginners in english

Native german speaker - so apologies for my english, no offense intended :)
drei
Posts: 479
Joined: Sun May 11, 2014 7:47 pm
Location: Mexico
Contact:

Re: Updating Organization Chart

Postby drei » Sat Mar 21, 2015 9:31 pm

So I've managed to get a new style set, please fell free to check it out.

Some clarifications: this is just a visual test. I am not satisfied with how I got to display the information, as you may see one column is designated to specify in what has the user contributed and next to it the names of the contributors, but it wastes a lot of space.

Also, I'm considering a couple of options:
  • A table with tabs to change from Development to Documentation, etc
  • Break the diagram into different collapsible categories so only the table title is displayed initially and then allow the reader to see what he is interested in
  • Use a similar style to the Second test, but use more columns like with the First test:

    Module | Example | Name | Another Module | Another Name

    Add to this that I break it down into categories like:
    • Development
      Table of contributors (only current ones)
    • Documentation
      Table of contributors (only current ones)
    • Publicity
      Table of contributors (only current ones)
    • All contributors
      List of all contributors
      • Name. Contributed to X.
I'll keep on tinkering until I find a solution that satisfies me, and as always feedback is appreciated.

Regards,
Isaac
Need help? Feel free to ask, but please read the guidelines first
ian.rees
Posts: 696
Joined: Sun Jun 15, 2014 3:28 am
Contact:

Re: Updating Organization Chart

Postby ian.rees » Wed Mar 25, 2015 9:31 pm

Hi Drei,

I think your second revision is moving in the right direction, the problem is that there's not enough visual connection between the module name and the list of contributors. So, what I'd suggest trying is:

* Move the peach-coloured "Modules" rowspan to the top of the table, where the "FreeCAD Development" header currently is (that header is redundant anyways)
* Align maintainer names to the left instead of centre
* Maybe add a spacer column, then another two columns of area-maintainer

Hope this helps! -Ian-
drei
Posts: 479
Joined: Sun May 11, 2014 7:47 pm
Location: Mexico
Contact:

Re: Updating Organization Chart

Postby drei » Sat Apr 11, 2015 5:19 am

First, I'll confess I slacked off and didn't do pretty much anything since my last post.

A new idea i got was to use this nifty command

Code: Select all

git shortlog -s -n
And to change the structure to the development to something like:

FreeCAD Code
  • Main and/or current developers:
    • List the founders and the most active .
  • List of all contributors:
    git account | Name | commits
And add the option to send a request to change, remove, etc. an account or person.

How about it?
Need help? Feel free to ask, but please read the guidelines first
User avatar
ralvejd
Posts: 58
Joined: Wed Feb 20, 2013 10:31 pm
Location: Sweden

Re: Updating Organization Chart

Postby ralvejd » Sat Apr 11, 2015 10:37 am

I played a bit with the table design, but I do not know if the wiki can handle rotated text.
Please ignore the table contents, I have just filled in a bit as an example.
org_chart.png
org_chart.png (137.55 KiB) Viewed 1962 times
sorry for my outrageous English, but I have a bad excuse
User avatar
shoogen
Posts: 2823
Joined: Thu Dec 01, 2011 5:24 pm

Re: Updating Organization Chart

Postby shoogen » Sat Apr 11, 2015 5:24 pm

drei wrote:A new idea i got was to use this nifty command

Code: Select all

git shortlog -s -n
The counts are only useful if you maintain a .mailmap

Code: Select all

  6021  Werner
  1655  Jürgen
  1627  Yorik