Ann: source code sharing wiki codewiki.wikispaces.com



Hello all,

I have set up a wiki for source code which is available for anyone to
use. It is intended to

* present source code clearly
* allow documentation to be present either with the source code or
separately
* allow anyone to make updates to the code and documentation


http://codewiki.wikispaces.com


Q1. How is it different from other source code repositories?

First, the site content is not owned by any person or company.

This means that others can add code to it without feeling that they
are contributing to someone else's web site. It is truly a community
resource. Neither does the site cost money to maintain. Its contents
can remain indefinitely as Wikispaces provides free hosting.


Second, anyone who sees a fault in code or documentation can correct
it.

This is the true essence of a wiki. Others are encouraged to make
changes as needed. There are checks and balances to see that the
original code is not lost. See the FAQ for details.


Q2. How will a person benefit from the site?

The site allows wide peer-review. Any code uploaded can be checked and
updated by anyone browsing. There is an option for discussion prior to
making changes.

If you don't want to publish code you can still
- download and use code posted by others
- browse to learn from code and documentation others have published

As implied by the last point the site is not for developing code from
scratch. There are other sites on the Internet for that purpose. Code
posted to codewiki should already be complete or it should be
educational in some way.


It won't suit everyone but may be appropriate for others. Take a look
and see if you would find it useful.

--
James
.



Relevant Pages

  • Re: TeX and friends
    ... There is a core of a Unix OS in the foundations, ... which does of course mean that it's easy to write a nice integrated GUI ... but what about when you can't write any documentation at all ... the source code is ...
    (uk.people.support.depression)
  • Re: Doc-O-Matic 3.7 released - Source Documentation System
    ... > Doc-O-Matic 3.7 is the latest version of our Source Code Documentation ... > PDF, HTML Help, Help 2 and Windows Help. ... > Markus Spoettl, ...
    (microsoft.public.dotnet.languages.vb)
  • Re: PIC/Linux
    ... and some documentation, shell scripts, etc., but nothing that needs to be made. ... and got a complaint that it couldn't find simulavr. ... I decided it would be helpful to look at the source code for the ... cpio --extract to extract the contents of the cpio file. ...
    (sci.electronics.misc)
  • Re: Python style: exceptions vs. sys.exit()
    ... So what's wrong with using the source as documentation? ... But when it comes to nitty-gritty details, source code is the ... language you don't understand (e.g. Python built-ins are written in C, ... language you understand and not too complicated for you to grasp, ...
    (comp.lang.python)
  • Re: What exactly does "Maximum Distance Exceded" mean?
    ... That's why looking at the source code is necessary to get you the ... good news bad news thing. ... problem with your ntp daemon, it's important to know what they mean. ... I read the explanation in the documentation, ...
    (comp.protocols.time.ntp)