Menu
▾
▴
generguide-user — Discussion for users of generguide
You can subscribe to this list here.
| 2003 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
(1) |
Sep
(3) |
Oct
|
Nov
|
Dec
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2004 |
Jan
|
Feb
|
Mar
|
Apr
|
May
(1) |
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
|
From: <ben...@id...> - 2004-05-25 07:45:50
|
Dear Open Source developer I am doing a research project on "Fun and Software Development" in which I kindly invite you to participate. You will find the online survey under http://fasd.ethz.ch/qsf/. The questionnaire consists of 53 questions and you will need about 15 minutes to complete it. With the FASD project (Fun and Software Development) we want to define the motivational significance of fun when software developers decide to engage in Open Source projects. What is special about our research project is that a similar survey is planned with software developers in commercial firms. This procedure allows the immediate comparison between the involved individuals and the conditions of production of these two development models. Thus we hope to obtain substantial new insights to the phenomenon of Open Source Development. With many thanks for your participation, Benno Luthiger PS: The results of the survey will be published under http://www.isu.unizh.ch/fuehrung/blprojects/FASD/. We have set up the mailing list fa...@we... for this study. Please see http://fasd.ethz.ch/qsf/mailinglist_en.html for registration to this mailing list. _______________________________________________________________________ Benno Luthiger Swiss Federal Institute of Technology Zurich 8092 Zurich Mail: benno.luthiger(at)id.ethz.ch _______________________________________________________________________ |
|
From: Cameron S. <ca...@sh...> - 2003-09-07 10:33:43
|
On Sunday 07 Sep 2003 6:05 pm, Artur Hefczyc wrote: > So I don't expect we will be able to support for example MSOffice documents > in short time. In order to attract users who have established processes, we need to consider how they can incorporate legacy data into the generguide framework. Either we need to: 1. accept souce documentation in a number of formats, or 2. provide import utilities to import from a number of formats. Technically, option 2 is much easier and is my prefered solution. In particular, it would be good to support WORD formats due to it's monopoly on documentation. For ethical reasons, I'd prefer to provide import utilites from WORD rather than accepting WORD as a source document. Reasons being: 1. WORD mixes content with presentation which makes it hard to export to a number of different formats and styles. 2. WORD does not conform to Open Standards. 3. WORD forces vendor lock-in and hence license lock-in. Something that should be avoided in an open source project. 4. I don't like the way Microsoft does business and try to avoid contact with them whenever possible. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Artur H. <ko...@pl...> - 2003-09-07 08:05:52
|
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Hi,
I would like to add something from me.
> > My first thoughts, having read the Web Site, is that the
> > principles of "generguide" must embody a broader concept
> > that can be applied independent of the DTD or XML Schema
> > used to create the XML Instances. Consequently, I think that
> > the principles should cater to a wider group of document
> > types. While Simplified DocBook is great for the purpose of
> > illustrating the concepts of "generguide" I think that the
> > application should be easily applied to the other doctypes.
Well, the one main ideas (as I correctly understand) is to provide framework
for using modular documentation.
This idea and tools we use are DTD or Schema independent.
They just process XML files and these XML files contains DTD declaration. So
tools don't know anything about particular DTD indeed.
Almost.
1. We have created xinclude DTD extension for DocBook but if another DTD will
be used than another DTD extension can be created if necessary (some of
other DTDs can have built-in xinclude support) and in fact it is not
visible 'outside' XML files because it is used as DTD, so our tools are
not dependent on it.
2. We use DocBook-XSL set for generating target formats from source XML files.
This XSL set is designed especially for DocBook files. I mean our scripts
points to this particular XSL templates. However, again, it can be easy
changed just by script customization.
3. Well, yes, we use SDocBook internally for our documents and recommend it
for other users. But it is the best supported DTD I know. At least the
best supported DTD in open source/free applications of this kind.
I mean these XLS templates which allows to generate target formats such as
HTML, PDF, XHTML, WinHelp, LaTeX and some others.
So, we should not have many problems with customization for other documents
types while they are XML files and unless you want to join documents using
different DTDs.
However if you mean not XML files as you are talking about different types,
than I must agree. Up to now we have been concentrating on XML files and
including for our concept, for example TeX files, can be a little be more
complex but not impossible.
We are going to provide command line, automatic tools for processing our files
as for example they are similar tools programming languages.
We want to:
1. allow anybody generate chosen target format of documentation in very easy
way with minimal installation effort.
2. allow to run these tools such as cron tasks
3. allow our framework to be integrated with other environments such as IDE or
documentation editing tools.
So I don't expect we will be able to support for example MSOffice documents in
short time.
Cameron I anything I wrote above is nonsense, please correct me.
Artur
- --
Artur Hefczyc "Don't change people, just live with them."
Open Source Developer:
http://www.geotools.org/
http://generguide.sourceforge.net/
http://wttools.sourceforge.net/
http://maven-plugins.sourceforge.net/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)
iD8DBQE/Wua90/6x1bjSKPkRAuULAKCfTavIlOerCVRgf5e1BtgvLzYCNwCfUBao
H+JLgPCQHmuqqYRUKlrxNro=
=yvqk
-----END PGP SIGNATURE-----
|
|
From: Cameron S. <ca...@sh...> - 2003-09-06 23:36:00
|
On Saturday 06 Sep 2003 8:48 pm, you wrote: > So, did you want to say something. Or just testing. Ah sorry, I was waiting for you to open the conversation. :) I didn't want to eager to suck up all your ideas and time and potentially scare you away. Sean Wheller wrote: > My first thoughts, having read the Web Site, is that the > > principles of "generguide" must embody a broader concept > > that can be applied independent of the DTD or XML Schema > > used to create the XML Instances. Consequently, I think that > > the principles should cater to a wider group of document > > types. While Simplified DocBook is great for the purpose of > > illustrating the concepts of "generguide" I think that the > > application should be easily applied to the other doctypes. I'd be interested to hear your ideas on this subject. What problems you think we will encounter and any ideas you may have on solving them? What do you think we should do to change the scope of the project? What applications, templates, etc should we be developing? I want to know HOW we should change what we are doing now. At the moment there are 2 people working on this project, Artur and myself. We are both programmers rather than tech writers and ideas on building a documentation structure are very welcome. Currently we are writing tools which will build a generguide configuration file, then build a document based on that file. I guess that will take a month or so to a point where we can release to the public. Oh, I'm also interested to know how you would like to help. Advice on stragagies? Write documentation? Work on the tools? Something else? -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-08-31 04:23:21
|
Hello Sean, I was hoping someone like you would show some interest in generguide, altho= ugh=20 you are a bit earlier than I expected. So far we have been very low key and have not announced the project anywher= e. =20 We wanted to clean up a few things first. How did you find us? On Saturday 30 Aug 2003 8:33 pm, Sean Wheller wrote: > Hello, > Please add me as one of the members. I've added you to the generguide-user email list (which we have not posted = to=20 yet, but probably will now you are here). You may also want to join the developer and announce email lists. See: http://sourceforge.net/mail/?group_id=3D83647 When you are ready, and if you are interested in writing documentation or=20 code, then I will give you commit access to the CVS repository. > In general I like the concept you are trying to develop with > > the project. However have a few minor concerns regarding > > the narrow scope. > > > > From experience, I know that the application of an OO model > > in authoring principles is very effective. I have used this > > technique for many years with great success. XML is by > > nature the best technology for such an implementation, > > providing many benefits and drawbacks. Both of which > > the =93generguide=94 project will have to address. > > > > My first thoughts, having read the Web Site, is that the > > principles of =93generguide=94 must embody a broader concept > > that can be applied independent of the DTD or XML Schema > > used to create the XML Instances. Consequently, I think that > > the principles should cater to a wider group of document > > types. While Simplified DocBook is great for the purpose of > > illustrating the concepts of =93generguide=94 I think that the > > application should be easily applied to the other doctypes. We chose Simple Docbook to: 1. Limit the scope of the project to a size we can address. 2. Go with existing standards. 3. It addressed the needs of our "Developer's Guide" documentation. I'd be interested to hear your ideas on this subject. What problems you th= ink=20 we will encounter and any ideas you may have on solving them. > > > > As an Information Architect and Technical Communicator I > > would like to assist. More information about myself is available > > at http://www.geocities.com/seanwhe Yes, you seem to have experience in many areas where I'm lacking. :) I'd be delighted to have you on board. In what ways would you like to help? =2D-=20 Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
