One thing that would be VERY helpful, IMHO, would be simply to separate the user information from the implementation instructions. I know there's some overlap, but having the two in the same place often makes it difficult to find what you're looking for at the time and to sort it out. It wouldn't be a deal-breaker if the two pointed into one another in order to clarify those few overlapping issues.
regards, Richard Erlacher ----- Original Message ----- From: "candida lopez rodriguez" <c.rodr...@rcn.com> To: <sdcc-user@lists.sourceforge.net> Sent: Saturday, March 07, 2009 11:29 AM Subject: Re: [Sdcc-user] May I offer a suggestion about the documentation? > On Saturday 07 March 2009 12:20:54 am Jacques Pelletier wrote: > > > My original intention was to point to other open source projects, the show > the > documentation and in the lower side the user can add comments, The problem > with the SDCC documentation is that is very biased to a single processor, > and > even then is not fully complete. is not such a big deal to allow the users > to > add information (and possible links to other sites where the users can > find > relevant information) > > > For the problem of providing out of scope information (such as ADC or > other > components) I partially agree. This is a C compiler and such the > documentation must cover the tool usage, but can we add something like > user > knowledge base with a big disclamer that this is user information and SDCC > does not monitor or validate the information wheing contained, so the > users > can add links or other pertinent information about those issues (and may > be > post questions to other users how to do something) > > > Thanks > > > > ------------------------------------------------------------------------------ > Open Source Business Conference (OSBC), March 24-25, 2009, San Francisco, > CA > -OSBC tackles the biggest issue in open source: Open Sourcing the > Enterprise > -Strategies to boost innovation and cut costs with open source > participation > -Receive a $600 discount off the registration fee with the source code: > SFAD > http://p.sf.net/sfu/XcvMzF8H > _______________________________________________ > Sdcc-user mailing list > Sdcc-user@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/sdcc-user ------------------------------------------------------------------------------ Open Source Business Conference (OSBC), March 24-25, 2009, San Francisco, CA -OSBC tackles the biggest issue in open source: Open Sourcing the Enterprise -Strategies to boost innovation and cut costs with open source participation -Receive a $600 discount off the registration fee with the source code: SFAD http://p.sf.net/sfu/XcvMzF8H _______________________________________________ Sdcc-user mailing list Sdcc-user@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/sdcc-user
