Re: [JPP-Devel] Fwd: Writing Help File and "Non-English Netiquette" (Giuseppe)

[Sunburned S. <sun...@gm...>]

All good comments Peppe! Please see my responses below.

Peppe wrote: "As I do not want to spend
time to solve this problem, I go on writing with
Openwriter. If you send me the Opendoc template I can coordinate
my job to yours."

I'll get you a document template for OpenOffice that you can use if
you would like. In fact, I think it is already online at SourceForge.
I will check.

Peppe wrote: "I also have no problem to use landscape for my
documets"

I think portrait makes more sense for a traditional word processor document.

Peppe wrote: "Regarding the original Title page I recived, It seemed
to me as a sort of descriptive page of function. In
this case some pictures would be useful expecially for
people who don't often use English"

I think I understand now. More pictures, less words. Pictures are
universal, whereas words have to be translated. :]

Peppe wrote: "Both works are usefull.
But we can evoid to write two times the same
functions. If you already have a list of arguments you
write, you can post it.
 In this way I evoid to be too much descriptive when I
write the same arguments and I can refer to yours."

I am giving second thoughts to my creation of new feature
documentation at this point. I think you will have already covered a
lot of this in your effort. I think it would be smarter for me to edit
and/or make suggestions to what you contribute, and then concentrate
on other forms of documentation. (For example, I can work on a
developer's guide, or on a more "task focused" user guide.)

Peppe wrote: "Since I never considered my job as "personal", but a
contribution to Openjump development,  you are very
welcome to add whatever explanation and correction
(see below) you think on them.
I probabily ask you an help since there are still some
functions that I don't know (see in last document what
I wrote in red fonts)."

I'll have to check your doc. I'm more than happy to try explaininf
functions in OpenJUMP, if I know how they work.

Have you determined what license you will release your documentation
under? Could I suggest one of the Creative Commons licenses if you
haven't decided yet?

Peppe wrote: "Which is the progress of online help and how can we
connect our both jobs with it (scribus doesn't export
to html)?
Should we put our jobs on the web page  even if  not
complete?"

I don't think that we have online help of any type. :[ I had
considered using JavaHelp for this, and even bought the JavaHelp book.
However, JavaHelp seemed a little complex for what I wanted, and we
are going to run into the same translation/layout problems that come
from mixed images and text. I was thinking of using a simple component
that displayed text on one side and images on another. I never got
around to it though. I didn't want to start something else I wouldn't
finish. :]

I'm going to take an hour or so after work one day a week to edit your
documentation. I'll start today.

The Sunburned Surveyor


On 6/26/07, Giuseppe Aruta <giu...@ya...> wrote:
>
> --- Sunburned Surveyor <sun...@gm...>
> ha scritto:
>
>
> SS
>
>
> Scribus runs very slow on my computer, I still don't
> know the reason (maybe because I use Windows? Maybe
> the version of Scibus?). As I do not want to spend
> time to solve this problem, I go on writing with
> Openwriter.
> If you send me the Opendoc template I can coordinate
> my job to yours
>
> I also have no problem to use landscape for my
> documets
>
> Regarding the original Title page I recived, It seemed
> to me as a sort of descriptive page of function. In
> this case some pictures would be useful expecially for
> people who don't often use English
>
>
> Regarding what you write: "I think you an I are
> working on a common goal but with slightly different
> approaches... ans so on", I came to the same point in
> these last days.
> Both works are usefull.
> But we can evoid to write two times the same
> functions. If you already have a list of arguments you
> write, you can post it.
>  In this way I evoid to be too much descriptive when I
> write the same arguments and I can refer to yours.
>
> I will go on posting the documents I write on
> JPP-DEVEL list, even if not complete, for 3 reasons
> 1) having back ideas and corrections,
> 2) giving ideas from a non developer's point of view
> (me)
> 3) helping newcomers to Openjump.
>
> By the time you correct my documents I think I can
> post them in the JPP-USER list to have more ideas from
> users - I want an idea from you
>
> Since I never considered my job as "personal", but a
> contribution to Openjump development,  you are very
> welcome to add whatever explanation and correction
> (see below) you think on them.
> I probabily ask you an help since there are still some
> functions that I don't know (see in last document what
> I wrote in red fonts).
>
> I have some questions:
> Which is the progress of online help and how can we
> connect our both jobs with it (scribus doesn't export
> to html)?
> Should we put our jobs on the web page  even if  not
> complete?
>
>
> Regarding your mail "List Etiquette and "Non-English"
> Speakers"
> Be patient, SS,   we "Italian hillbillies" use a lot
> of these fancy words like "sorry, excuseme or thanks"
> in our language and sometimes it is difficult to exit
> a linguistic habit. I'll try to ban these words from
> my English Dictionary.
>
> Regarding the Idea to split community in  different
> linguistic groups. This never don't make me no never
> mind nohow. Let's go on using English (despite
> problems)  until we consider to use other
> international languages (Spanish, Esperanto, Arab or
> Swahili) ;-)
>
> Peppe
>
>
>
>
>
>
> ___________________________________
> L'email della prossima generazione? Puoi averla con la nuova Yahoo! Mail:
> http://it.docs.yahoo.com/nowyoucan.html
>
> -------------------------------------------------------------------------
> This SF.net email is sponsored by DB2 Express
> Download DB2 Express C - the FREE version of DB2 express and take
> control of your XML. No limits. Just data. Click to get it now.
> http://sourceforge.net/powerbar/db2/
> _______________________________________________
> Jump-pilot-devel mailing list
> Jum...@li...
> https://lists.sourceforge.net/lists/listinfo/jump-pilot-devel
>