Re: [generguide-devel] One of ways to popularize project:

[Artur H. <ko...@pl...>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Saturday 28 of June 2003 16:35, Cameron Shorter wrote:
> On Friday 27 Jun 2003 3:40 pm, Artur Hefczyc wrote:
> > As I noted google refreshes his data base about twice a week.
> > So it seems to me it would be good to publish all our sections
> > as sample guides on project site.
> Yes, it is already part of the site.  See links at:
> http://generguide.sourceforge.net/sampleguides.html
> (This guide is a week or 2 old)
> Is this what you are talking about?

I was thinking about something different.
We have more than 50 SGML files in directory generguide/guide.
I suggest to generate HTML version of all of them and make them
available from project web site.

I can see 2 benefits:
1. Someone browsing and reading our project site can think something
like that: 
"Interesting project, authors suggest to use their documents as
templates and patterns for my project developers guide. Ok, I would 
like to see first, what parts I can use for my guide and than maybe
I will try to use it."
So giving easy access to HTML version we can improve chance
that someone start to use it.
It seems to me giving full sample guide (GeoTools) is not exactly the same.

I have also another idea what is next step after above. If you agree for
such move I would like to create page containing list of all sections
places in following HTML form:
input1: "Project name"
input2: "Project site"
input3: "Project developer"
list of checkboxes for each available section (each section name is URL to 
section text):
x  -  cvs
x  -  ant
x  -  doc license
x  -  design
x  -  coding conventions
<submit>
After user fill form and click <submit> button, sample developers guide
should be generated. I think it should not be very difficult to set it up on
SF site as cgi script.

2. Our documents describe many aspects of software development.
If we present them on project site, google will index them in it's DB.
So I expect people looking for particular development information can
find our project site much easier. The more they can not only learn
something about subject they are interested in at the moment of reading
but also they can find our project interesting for different purposes than
just source of information.

I did some experiment in few last weeks. I put some pages (I wrote earlier) 
about emacs, jdee and xml on my home machine and pointed to them
from wttools project site.
I have been watching logs about pages visit. Most of visitors were
directed to my machine from Google as response to query containing
for example: "emacs xml" or "dtd xml".

Artur
- -- 
Artur Hefczyc
Open Source Developer
http://generguide.sourceforge.net/
http://www.geotools.org/
http://wttools.sourceforge.net/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)

iD8DBQE+/gR10/6x1bjSKPkRAj/QAJ9oruVtKYyOTL5vj5j6rZme86gqzACfeobx
nfxiDwczyxntfCl664BIw9I=
=jySp
-----END PGP SIGNATURE-----