Litt mer.

[homepage.git] / mypapers / free-sw-devel / free-sw-devel.html

diff --git a/mypapers/free-sw-devel/free-sw-devel.html b/mypapers/free-sw-devel/free-sw-devel.html
index defe1fe5db0a4e0285bd0c6d96388014fa0acf82..d44fea8ed5340220ae7f64cf30dcd63d44645ef4 100644 (file)
--- a/mypapers/free-sw-devel/free-sw-devel.html
+++ b/mypapers/free-sw-devel/free-sw-devel.html
@@ -51,51 +51,95 @@
     </ul>
 
     <p><em>Richard M. Stallmann, FSF</em></p>
-       
 
     <h2>Getting involved and helping out</h2>
 
-    - use mailing lists
-    - irc, wiki
+    <p>So, you found a nice project on Freshmeat, and want to help
+      improve the project...</p>
+
+    <ul>
+
+      <li>read the project documentation
+      <li>join the relevant mailing list, IRC channels, etc
+      <li>use mailing lists
+      <li>irc, wiki
+      <li>get to know the source
+      <li>understand licensing issues
+      <li>get used to for public review
+      <li>learn to use the bug tracking system
+      <li>start with the non-coding stuff (translations, documentation)
+      <li>do not take it personally
+
+    </ul>
 
     <h2>Reporting bugs</h2>
 
+    <p>This software suck.  A lot!</p>
+
+    - do not report duplicate bugs
+    - document how to reproduce the bug
+    - include relevant information
+
+- sysadmin/feilrapportør
+
+  - Hvis du finner en feil
+    - søk i bug-databasen til produktet om dette er en kjent feil
+    - hvis ikke, test siste utgave lokalt
+    - hvis feilen fremdeles er der, og er gjenproduserbar, send en
+      feilrapport (valgrind, strace, gdb, ltrace)
+    - hvis feilen ikke er fikset, men utviklerne er klar over denne,
+      send en feilrapport til!
+    - sørg for at feilrapporten inneholder nødvendig informasjon for å
+      gjenprodusere feilen og hvordan systemet ditt er konfigurert
+    - bruk gjerne feilrapporteringsverktøy som bug-buddy (Gnome),
+      perlbug (Perl), reportbug (Debian) sendpr (FreeBSD), eller
+      produktets feilrapporterings-webside (bugzilla, request-tracker,
+      gnats e.l. Se på prosjektets hjemmeside)
+    - husk å følge opp feilrapporten din
+
+    <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306147">an
+    example</a>
+    
     <h2>Joining a free software project</h2>
 
     - painful
 
     <h2>Starting a free software project</h2>
 
-    <ul>
+    <p>I got this idea for a piece of software...</p>
 
-      <li>Reuse when possible, improve existing projects</li>
+    <ul>
 
-      <li>
+      <li>reuse when possible, prefer to improve existing
+      projects</li>
 
-    - avoid starting from scratch, reuse an existing project if
-      possible.
+      <li>read other peoples code, download and test other peoples
+      programs</li>
 
+      <li>understand software licenses
 
+       
+    </ul>
 
+    <h2>Running a successful free software project</h2>
+
+      - let everyone work on the things that interests them
+      - do not accept every change.  make sure you like it first
+      - write down where you want the project to go
+    - set up a bug tracking systems
+    - create web pages
+      - screen shots
+      - short summary
+      - who to contact for more info
+    - include a README in the tarball
+      - home page URL
+      - download site URL
+      - short description
+      - where to send bug reports and patches
 
  - public review (anonymous CVS, commit emails)
- - bug tracking systems
  - licenses
- - download and test other peoples the programs
- - read other peoples code
  - give well-formed bug reports, and include a patch if possible
- - let everyone work on the things that interests them
- - do not accept every change.  make sure you like it first
- - write down where you want the project to go
- - web pages
-   - screen shots
-   - short summary
-   - who to contact for more info
- - source README
-   - home page URL
-   - download site URL
-   - short description
-   - where to send bug reports and patches
  - consider sourceforge
  - tools
    - compiler
@@ -112,23 +156,6 @@
     - fortell din lokale sysadmin om feilen, og be personen teste
       nyere versjoner og/eller å skrive en feilrapport
 
-- sysadmin/feilrapportør
-
-  - Hvis du finner en feil
-    - søk i bug-databasen til produktet om dette er en kjent feil
-    - hvis ikke, test siste utgave lokalt
-    - hvis feilen fremdeles er der, og er gjenproduserbar, send en
-      feilrapport (valgrind, strace, gdb, ltrace)
-    - hvis feilen ikke er fikset, men utviklerne er klar over denne,
-      send en feilrapport til!
-    - sørg for at feilrapporten inneholder nødvendig informasjon for å
-      gjenprodusere feilen og hvordan systemet ditt er konfigurert
-    - bruk gjerne feilrapporteringsverktøy som bug-buddy (Gnome),
-      perlbug (Perl), reportbug (Debian) sendpr (FreeBSD), eller
-      produktets feilrapporterings-webside (bugzilla, request-tracker,
-      gnats e.l. Se på prosjektets hjemmeside)
-    - husk å følge opp feilrapporten din
-
 
 - patch-bidragsyter