Hi,
When Christopher was in Prague, a few of us had a brainstorming about
the need of having devel-documentation placed directly in a
Yast/libstorage/linuxrc repository. There are no doubts that it's one of
the most important parts of projects hosted at GitHub. All their howtos
mention "create README[.md]" as the very first step.
In fact, we'll have new hires in the team and in such situations, good
documentation is one of the most important parts. Good documentation
goes from very high level to lower and lower level.
We have already summarized that in Yast Team Challenges, but the summary
doesn't belong to this document as it's too detailed. That's why I'm
putting it here as a WIP item and deleting it from that document:
--- cut ---
The README should at least describe the steps needed for maintenance
(for a person without expert knowledge in the area) including:
* What is the project good for - what does it actually do (and how),
what it cannot do (unsupported scenarios), limitations
* Links to the documentation, high level and low level descriptions
(e.g. RFC, wikipedia articles, man pages, project documentation,
openSUSE wiki), terminology
* How to fetch the source code (if something outside Git is needed it
should be mentioned)
* What prerequisites are needed to build the sources (external
libraries, gems, scripts, …)
* How to build the sources (make/rake commands…)
* How to setup a testing environment (e.g. iSCSI target for iSCSI
client)
* How to run the code to test a change (esp. needed for non trivial
projects like linuxrc)
* How to run automated tests
* How to build a package for submission
* How to submit the package (if it needs some manual steps)
* Troubleshooting (how to solve typical problems)
The README should be reasonably short, if some section is too long it
should be moved to a separate document (or to GitHub wiki) and linked.
--- cut ---
The project consists of
- Taking a decision where to go
- How to get there
- Implementing this important documentation
Those two who, according to my knowledge, were working on this were
Ladislav and Christopher, but there were not the only ones and a pilot
project for READMEs has been done a few months ago by Martin. It's still
not finished, but moving forward.
Thanks
Lukas
--
Lukas Ocilka, Systems Management (Yast) Team Leader
SLE Department, SUSE Linux
--
To unsubscribe, e-mail: yast-devel+unsubscribe(a)opensuse.org
To contact the owner, e-mail: yast-devel+owner(a)opensuse.org
I want to fix yast2-slide-show for SLE11 SP3. Which git commands do I
have to use, please?
Thus far, I have checked out trunk only.
--
Karl Eichwalder SUSE LINUX Products GmbH
R&D / Documentation Maxfeldstraße 5
90409 Nürnberg, Germany
GF: Jeff Hawn, Jennifer Guild, Felix Imendörffer, HRB 16746 (AG Nürnberg)
--
To unsubscribe, e-mail: yast-devel+unsubscribe(a)opensuse.org
To contact the owner, e-mail: yast-devel+owner(a)opensuse.org
This email is automatic generated from yast CI node. It lists of pull requests that have no activity more then three working days. If your module is listed, please check all pull request, why they are not merged yet.
Pending requests in repository yast-network:
- Fixed changing configuration name when adding new device (9 days)
https://github.com/yast/yast-network/pull/284
- Autoyast: do not overwrite firewall settings (36 days)
https://github.com/yast/yast-network/pull/275
Pending requests in repository yast-nis-server:
- Added command line support for Active Slave sync (14 days)
https://github.com/yast/yast-nis-server/pull/6
Pending requests in repository yast-theme:
- Install scalable icons & fix name of yast-yast-language.* to yast-language.* (182 days)
https://github.com/yast/yast-theme/pull/45
Pending requests in repository yast-yast2:
- Added generic README files (6 days)
https://github.com/yast/yast-yast2/pull/346
- Use native Ruby implementations in Yast::URL and Yast::IP (44 days)
https://github.com/yast/yast-yast2/pull/310
Pending requests in repository yast-docker:
- Start making this a gem (143 days)
https://github.com/yast/yast-docker/pull/2
--
To unsubscribe, e-mail: yast-devel+unsubscribe(a)opensuse.org
To contact the owner, e-mail: yast-devel+owner(a)opensuse.org
This email is automatic generated from yast CI node. It lists of pull requests that have no activity more then three working days. If your module is listed, please check all pull request, why they are not merged yet.
Pending requests in repository yast-network:
- Fixed changing configuration name when adding new device (8 days)
https://github.com/yast/yast-network/pull/284
- Autoyast: do not overwrite firewall settings (35 days)
https://github.com/yast/yast-network/pull/275
Pending requests in repository yast-nis-server:
- Added command line support for Active Slave sync (13 days)
https://github.com/yast/yast-nis-server/pull/6
Pending requests in repository yast-theme:
- Install scalable icons & fix name of yast-yast-language.* to yast-language.* (181 days)
https://github.com/yast/yast-theme/pull/45
Pending requests in repository yast-yast2:
- Added generic README files (5 days)
https://github.com/yast/yast-yast2/pull/346
- Use native Ruby implementations in Yast::URL and Yast::IP (43 days)
https://github.com/yast/yast-yast2/pull/310
Pending requests in repository yast-docker:
- Start making this a gem (142 days)
https://github.com/yast/yast-docker/pull/2
--
To unsubscribe, e-mail: yast-devel+unsubscribe(a)opensuse.org
To contact the owner, e-mail: yast-devel+owner(a)opensuse.org
Introducing our 3D/2D animation services.
We are specialized in providing 3D designing/modelling/animation services
across the globe. From 3D architecture, character animation, 3D
industrialdesign, rendering, prototype animation to 3D walkthroughs, we
provide high
quality effects to provide a virtual product.
We do mainly belowings:
3D Animation
2D Animation
Architecture Visualization
Character Animation
Animated Commercial
Product Modelling
Animated Presentation
Walkthrough Animation
Animated Movies
Looking forward to start cooperation with you soon.
Thanks,
Roy
Email: donghuacon(a)tom.com
--
To unsubscribe, e-mail: yast-devel+unsubscribe(a)opensuse.org
To contact the owner, e-mail: yast-devel+owner(a)opensuse.org
This email is automatic generated from yast CI node. It lists of pull requests that have no activity more then three working days. If your module is listed, please check all pull request, why they are not merged yet.
Pending requests in repository yast-network:
- Fixed changing configuration name when adding new device (6 days)
https://github.com/yast/yast-network/pull/284
- Autoyast: do not overwrite firewall settings (33 days)
https://github.com/yast/yast-network/pull/275
Pending requests in repository yast-nis-server:
- Added command line support for Active Slave sync (11 days)
https://github.com/yast/yast-nis-server/pull/6
Pending requests in repository yast-theme:
- Install scalable icons & fix name of yast-yast-language.* to yast-language.* (179 days)
https://github.com/yast/yast-theme/pull/45
Pending requests in repository yast-yast2:
- Use native Ruby implementations in Yast::URL and Yast::IP (41 days)
https://github.com/yast/yast-yast2/pull/310
Pending requests in repository yast-docker:
- Start making this a gem (140 days)
https://github.com/yast/yast-docker/pull/2
--
To unsubscribe, e-mail: yast-devel+unsubscribe(a)opensuse.org
To contact the owner, e-mail: yast-devel+owner(a)opensuse.org
This email is automatic generated from yast CI node. It lists of pull requests that have no activity more then three working days. If your module is listed, please check all pull request, why they are not merged yet.
Pending requests in repository yast-network:
- Autoyast: do not overwrite firewall settings (32 days)
https://github.com/yast/yast-network/pull/275
Pending requests in repository yast-nis-server:
- Added command line support for Active Slave sync (10 days)
https://github.com/yast/yast-nis-server/pull/6
Pending requests in repository yast-theme:
- Install scalable icons & fix name of yast-yast-language.* to yast-language.* (178 days)
https://github.com/yast/yast-theme/pull/45
Pending requests in repository yast-yast2:
- Use native Ruby implementations in Yast::URL and Yast::IP (40 days)
https://github.com/yast/yast-yast2/pull/310
Pending requests in repository yast-docker:
- Start making this a gem (139 days)
https://github.com/yast/yast-docker/pull/2
--
To unsubscribe, e-mail: yast-devel+unsubscribe(a)opensuse.org
To contact the owner, e-mail: yast-devel+owner(a)opensuse.org
This email is automatic generated from yast CI node. It lists of pull requests that have no activity more then three working days. If your module is listed, please check all pull request, why they are not merged yet.
Pending requests in repository yast-network:
- Autoyast: do not overwrite firewall settings (29 days)
https://github.com/yast/yast-network/pull/275
Pending requests in repository yast-nis-server:
- Added command line support for Active Slave sync (7 days)
https://github.com/yast/yast-nis-server/pull/6
Pending requests in repository yast-theme:
- Install scalable icons & fix name of yast-yast-language.* to yast-language.* (175 days)
https://github.com/yast/yast-theme/pull/45
Pending requests in repository yast-yast2:
- Use native Ruby implementations in Yast::URL and Yast::IP (37 days)
https://github.com/yast/yast-yast2/pull/310
Pending requests in repository yast-docker:
- Start making this a gem (136 days)
https://github.com/yast/yast-docker/pull/2
--
To unsubscribe, e-mail: yast-devel+unsubscribe(a)opensuse.org
To contact the owner, e-mail: yast-devel+owner(a)opensuse.org