Hi,

People can say that some documentation are outdated but for buses connections 
it's the other way around.
I'm pretty sure "indated" it's not a word ;-)

The eeschema docs section 6.5.3 Connections (Buses) for KiCad v5.1.5 contains 
instructions for features specific to v6.0 :

- 
https://docs.kicad-pcb.org/5.1.5/en/eeschema/eeschema.html#wires-buses-labels-power-ports

This has been reported as issue 772 and 773 :

- https://gitlab.com/kicad/services/kicad-doc/issues/773
- https://gitlab.com/kicad/services/kicad-doc/issues/772


Clearly, those commits should'nt have been included on 5.1 releases :
- 5fd00e738 Initial documentation for bus upgrades
- 29ed809ec Note new behavior of conflicting labels
- d27c40092 Add documentation for Migrate Buses dialog


I could be wrong (I'm new here) but I think the current git workflow for the 
doc team is :
1) master is the current documentation, every improvements and pull request 
goes on master (to make life easier for translators, there's only master that 
matters)
2) when KiCad reach features freeze, the new features are documented again 
against master and translators do their work until official release
3) official release, master gets tagged with the same version number like all 
Kicad repos
4) if we need to work on previous documentation, we could branch out of a 
specific release. Master is still the current documentation and we're back to 
step 1).


So my question is how could we solve those gitlab issues ?
Do we leave documentation with mistakes until next KiCad release ?

When are docs.kicad-pcb.org website updated ? I assume the website can be 
updated between official KiCad releases (if we haven't one we could adopt a 
strategy to schedule documentation update to the website, for example every 2 
months).


If we stick to the workflow above, we have to rollback those 3 commits and put 
them back in only when v6.0 reach features freeze.

I'm open to better ideas.


Francisco

-- 
Mailing list: https://launchpad.net/~kicad-doc-devs
Post to     : kicad-doc-devs@lists.launchpad.net
Unsubscribe : https://launchpad.net/~kicad-doc-devs
More help   : https://help.launchpad.net/ListHelp

Reply via email to