Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 499852 - Can we document development workflow?
Summary: Can we document development workflow?
Status: RESOLVED NEEDINFO
Alias: None
Product: Documentation
Classification: Unclassified
Component: Devmanual (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo Devmanual Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-01-30 23:16 UTC by Tom Wijsman (TomWij) (RETIRED)
Modified: 2020-01-23 12:21 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Tom Wijsman (TomWij) (RETIRED) gentoo-dev 2014-01-30 23:16:32 UTC
Can we document the development workflow in the devmanual? Currently it is undocumented and thus people take different approaches to it; some use emerge (which is slow and broken), some use ebuild (which doesn't check dependencies, thus yield invalid bugs and time lost debugging) and others use wrappers or other magic to accomplish what they want (which can have other deficiencies).

Besides that, tools like 'eshowkw' could be highlighted, as well as certain scripts used to bump ebuilds, run readelf over the installed files, etc...

Establishing a workflow as well as bringing together scripts into a tool can help new developers (and long time developers too) increase the quality of their work.
Comment 1 Michael Palimaka (kensington) gentoo-dev 2014-01-31 13:51:09 UTC
Are you proposing enforcing a standard workflow for everyone?
Comment 2 Tom Wijsman (TomWij) (RETIRED) gentoo-dev 2014-01-31 20:36:54 UTC
No, just documenting a common way to do it; because now we don't document anything at all which makes people use a wrong workflow that causes trouble, it can also be very welcome for new developers to get an idea of which things are commonly done as well as start of from an approach that's deemed good.

In no way this should enforce the workflow; if individual people want to do things differently (while keeping a similar amount of quality), they can do so.

(Note: Some parts of the workflow are however already enforced policies, like repoman and updating the ChangeLog; but they are shattered around the policy)
Comment 3 Michael Palimaka (kensington) gentoo-dev 2014-02-01 14:55:25 UTC
OK, that's good to know.

Did you have a particular workflow in mind? It could be interesting to survey developers to see what everyone does, I'm sure there are some good undocumented tricks out there.
Comment 4 Ulrich Müller gentoo-dev 2020-01-23 12:21:46 UTC
No progress, therefore closing.
Feel free to reopen with a patch attached.