* Re: suggestion
2002-01-28 10:59 ` suggestion Patrick Gundlach
@ 2002-01-28 12:01 ` Hans Hagen
2002-01-28 20:11 ` Re[2]: suggestion Giuseppe Bilotta
2002-01-28 12:33 ` suggestion Hans Hagen
` (4 subsequent siblings)
5 siblings, 1 reply; 16+ messages in thread
From: Hans Hagen @ 2002-01-28 12:01 UTC (permalink / raw)
Cc: ntg-context
At 11:59 AM 1/28/2002 +0100, Patrick Gundlach wrote:
>More important is to "rate" the questions:
>
>1) is it a question to wich the answer can be found in the
>manual? Then there is already a documentation for it and we do
>not need to answer it again.
>
>2) is it a question that has not yet been documented? Say for
>example "how can I draw a line below the headline?". (I actually
>do not know if this is in the manual). In this case, we (Hans :->
>) should see this as an opportunity to add a few lines to the
>manual, so the next time this questions will not be asked again.
>
>3) a questions that is related to the installation. For example
>the texhash or mktexlsr thing. Or the cont-sys.ori/cont-sys.tex
>stuff. I think these are worth being documented in some extra
>document.
or some flow chart or if-then thing; people tend to oversee such things
when reading a manual
>4) bug reports. We do not need to collect them, since one hour
>later 96% of them are already fixed. Just search the archive if
>you have some trouble.
-)
>5) Questions regarding fonts/encodings. Yuck. I have no clue what to do
>with them. There is really something that has to be done. I know
>that there is are docs. But there are a many questions on the
>list concerning this subject.
this is also related to "if it can be done then people will use it" or if
you see otehr users use it ... ; this is therefore also a combined user
effort: providing examples
>6) request for improvements. They are probably documented in
>Hans' privat todo list... I there a need to collect them? I
>think yes.
right, i wonder if we can use bugzilla for this (tobias is looking into
that for (real big) bugs)
>7) Questions like "How can this feature xyz (just think of gb's
>indefinate long page that got cut off after each chapter) be
>achieved? These questions are often very esoteric. But imho they
>are worth being collected.
right, which makes me wonder why gb is so silent, he must have run out of
feature requests
>So what is my conclusion? Ignore some questions, improve the
>documentation where necessary, collect some stuff for an extra
>doc. We do not need an faq.
not a faq in the traditional sense; we may need a way to organize examples
made by users (based on q/a's)
Hans
-------------------------------------------------------------------------
Hans Hagen | PRAGMA ADE | pragma@wxs.nl
Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
tel: +31 (0)38 477 53 69 | fax: +31 (0)38 477 53 74 | www.pragma-ade.com
-------------------------------------------------------------------------
fall-back web server:
www.pragma-pod.nl
-------------------------------------------------------------------------
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re[2]: suggestion
2002-01-28 12:01 ` suggestion Hans Hagen
@ 2002-01-28 20:11 ` Giuseppe Bilotta
0 siblings, 0 replies; 16+ messages in thread
From: Giuseppe Bilotta @ 2002-01-28 20:11 UTC (permalink / raw)
Cc: ntg-context
Monday, January 28, 2002 Hans Hagen wrote:
>>7) Questions like "How can this feature xyz (just think of gb's
>>indefinate long page that got cut off after each chapter) be
>>achieved? These questions are often very esoteric. But imho they
>>are worth being collected.
HH> right, which makes me wonder why gb is so silent, he must have run out of
HH> feature requests
ROTFLASTC
I'm being silent because I'm studying ... and waiting.
I'm studying for something rather unrelated to TeX (i.e. my
doctorate --exams on 2002.02.18), so I don't have too much time to
play with ConTeXt.
And I'm waiting for the new math module to come out with all the
stuff, so that I can convert my pre-existing AMS-LaTex documents
to ConTeXt and start writing the Universal Mathematical Book Of
The University Of Catania (UMBOTUOC, LOL) --which of course is of
no interest for anybody but me and the other students, but will of
course raise a thousand and one requests for new features ;-)
I'm also waiting for the module interface to TeXUtil, and finally,
I'm working myself on implenting/improving one of my feature
requests (the xdesc module, to be now augmented with better
enumerations).
I need to study better the referencing mechanism, especially the
part about "chain" references (a group of things which refer to
each other). If you have suggestions on what's the better way to
implement this, please tell me.
--
Giuseppe "Oblomov" Bilotta
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: suggestion
2002-01-28 10:59 ` suggestion Patrick Gundlach
2002-01-28 12:01 ` suggestion Hans Hagen
@ 2002-01-28 12:33 ` Hans Hagen
2002-01-28 12:40 ` suggestion Taco Hoekwater
` (3 subsequent siblings)
5 siblings, 0 replies; 16+ messages in thread
From: Hans Hagen @ 2002-01-28 12:33 UTC (permalink / raw)
Cc: ntg-context
Hi,
2) is it a question that has not yet been documented? Say for
>example "how can I draw a line below the headline?". (I actually
>do not know if this is in the manual). In this case, we (Hans :->
>) should see this as an opportunity to add a few lines to the
>manual, so the next time this questions will not be asked again.
let's make sure of that; i uploaded a beta version that permits usage of
before/after, although with some limitations; i hope that this change
(extension) does not break existing code
%D Although it is far better to use backgrounds for this
%D purpose, one can add a rule in the following way. This
%D method makes the rules disappear in case of an empty text
%D line. Consider this a feature.
%D
%D \starttypen
%D \setupheadertexts[left][right]
%D
%D \setupheader[text][after=\hrule,style=bold]
%D
%D \starttext
%D \input tufte \page
%D \setupheader[state=empty]
%D \input tufte \page
%D \stoptext
%D \stoptypen
Hans
-------------------------------------------------------------------------
Hans Hagen | PRAGMA ADE | pragma@wxs.nl
Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
tel: +31 (0)38 477 53 69 | fax: +31 (0)38 477 53 74 | www.pragma-ade.com
-------------------------------------------------------------------------
fall-back web server:
www.pragma-pod.nl
-------------------------------------------------------------------------
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: suggestion
2002-01-28 10:59 ` suggestion Patrick Gundlach
2002-01-28 12:01 ` suggestion Hans Hagen
2002-01-28 12:33 ` suggestion Hans Hagen
@ 2002-01-28 12:40 ` Taco Hoekwater
2002-01-28 12:48 ` suggestion Eckhart Guthöhrlein
` (2 subsequent siblings)
5 siblings, 0 replies; 16+ messages in thread
From: Taco Hoekwater @ 2002-01-28 12:40 UTC (permalink / raw)
Cc: ntg-context
On Mon, 28 Jan 2002 11:59:27 +0100
"Patrick Gundlach" <gundlach@irb.cs.uni-dortmund.de> wrote:
> 4) bug reports. We do not need to collect them, since one hour
> later 96% of them are already fixed. Just search the archive if
> you have some trouble.
These DO need to be documented. Otherwise, we spend a lot of
time answering questions to people that run into bugs in the
outdated version of context they are using.
--
groeten,
Taco
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: suggestion
2002-01-28 10:59 ` suggestion Patrick Gundlach
` (2 preceding siblings ...)
2002-01-28 12:40 ` suggestion Taco Hoekwater
@ 2002-01-28 12:48 ` Eckhart Guthöhrlein
2002-01-28 13:02 ` suggestion Eckhart Guthöhrlein
2002-01-28 21:28 ` suggestion Daniel Pittman
5 siblings, 0 replies; 16+ messages in thread
From: Eckhart Guthöhrlein @ 2002-01-28 12:48 UTC (permalink / raw)
Cc: ntg-context
Patrick Gundlach wrote:
> We have to analyse the questions asked on the list. In my
> opinion it does not make sens just to copy the question and the
> correct answer and make a digest. This would not do any good,
> because we then just have a mere copy of the mailinglist
> (stripped down to the essentials, indeed)
>
> More important is to "rate" the questions:
>
I agree with you. As Hans suggested, everybody could compile a QA for his particular case. But for a sensible faq - if we want it - one person will probably have to edit and sort them.
> 1) is it a question to wich the answer can be found in the
> manual? Then there is already a documentation for it and we do
> not need to answer it again.
Optimistic.
>
> 2) is it a question that has not yet been documented? Say for
> example "how can I draw a line below the headline?". (I actually
> do not know if this is in the manual). In this case, we (Hans :->
> ) should see this as an opportunity to add a few lines to the
> manual, so the next time this questions will not be asked again.
>
> 3) a questions that is related to the installation. For example
> the texhash or mktexlsr thing. Or the cont-sys.ori/cont-sys.tex
> stuff. I think these are worth being documented in some extra
> document.
>
> 4) bug reports. We do not need to collect them, since one hour
> later 96% of them are already fixed. Just search the archive if
> you have some trouble.
>
> 5) Questions regarding fonts/encodings. Yuck. I have no clue what to do
> with them. There is really something that has to be done. I know
> that there is are docs. But there are a many questions on the
> list concerning this subject.
>
> 6) request for improvements. They are probably documented in
> Hans' privat todo list... I there a need to collect them? I
> think yes.
>
> 7) Questions like "How can this feature xyz (just think of gb's
> indefinate long page that got cut off after each chapter) be
> achieved? These questions are often very esoteric. But imho they
> are worth being collected.
>
> So what is my conclusion? Ignore some questions, improve the
> documentation where necessary, collect some stuff for an extra
> doc. We do not need an faq.
>
>
>
>
>
> Viele Grüße,
>
> Patrick Gundlach
>
>
>
>
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: suggestion
2002-01-28 10:59 ` suggestion Patrick Gundlach
` (3 preceding siblings ...)
2002-01-28 12:48 ` suggestion Eckhart Guthöhrlein
@ 2002-01-28 13:02 ` Eckhart Guthöhrlein
2002-01-28 13:44 ` suggestion Hans Hagen
2002-01-28 21:28 ` suggestion Daniel Pittman
5 siblings, 1 reply; 16+ messages in thread
From: Eckhart Guthöhrlein @ 2002-01-28 13:02 UTC (permalink / raw)
Cc: ntg-context
Sorry, accidentally pressed the send button ;-) Completed version follows.
Patrick Gundlach wrote:
> We have to analyse the questions asked on the list. In my
> opinion it does not make sens just to copy the question and the
> correct answer and make a digest. This would not do any good,
> because we then just have a mere copy of the mailinglist
> (stripped down to the essentials, indeed)
>
> More important is to "rate" the questions:
I agree with you. As Hans suggested, everybody could compile a QA for
his particular case. But for a sensible faq - if we want it - one person
will probably have to edit and sort them.
> 1) is it a question to wich the answer can be found in the
> manual? Then there is already a documentation for it and we do
> not need to answer it again.
Optimistic.
> 2) is it a question that has not yet been documented? Say for
> example "how can I draw a line below the headline?". (I actually
> do not know if this is in the manual). In this case, we (Hans :->
> ) should see this as an opportunity to add a few lines to the
> manual, so the next time this questions will not be asked again.
I don't know if Hans has enough time to update the documentation
continually... Perhaps an entry in our list, which can be removed by the
maintainer if updated documentation becomes available.
> 3) a questions that is related to the installation. For example
> the texhash or mktexlsr thing. Or the cont-sys.ori/cont-sys.tex
> stuff. I think these are worth being documented in some extra
> document.
Shouldn't this go into the existing installation instructions? (Or to
the faq, in the meantime...)
> 4) bug reports. We do not need to collect them, since one hour
> later 96% of them are already fixed. Just search the archive if
> you have some trouble.
One of the greatest things about context, isn't it?
> 5) Questions regarding fonts/encodings. Yuck. I have no clue what to do
> with them. There is really something that has to be done. I know
> that there is are docs. But there are a many questions on the
> list concerning this subject.
Can't say too much about this. But probably mfonts.pdf is not very
explicit / understandable / complete if there remain so many questions?
> 6) request for improvements. They are probably documented in
> Hans' privat todo list... I there a need to collect them? I
> think yes.
We would have to decide what wishes should be put on the todo list. I
think not everything a single person might want to have can actually be
included, that's why a todo list with priorities would be useful. One of
the key factors for determining this priority are certainly Hans' own
needs and projects, so the best place for the list is in his hands -
where it is.
> 7) Questions like "How can this feature xyz (just think of gb's
> indefinate long page that got cut off after each chapter) be
> achieved? These questions are often very esoteric. But imho they
> are worth being collected.
That is at least some kind of a faq, isn't it?
> So what is my conclusion? Ignore some questions, improve the
> documentation where necessary, collect some stuff for an extra
> doc. We do not need an faq.
Ok, let's call it 'Miscellaneous Madness' instead of faq, in honour of
its esoteric parts.
Eckhart
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: suggestion
2002-01-28 13:02 ` suggestion Eckhart Guthöhrlein
@ 2002-01-28 13:44 ` Hans Hagen
0 siblings, 0 replies; 16+ messages in thread
From: Hans Hagen @ 2002-01-28 13:44 UTC (permalink / raw)
Cc: Patrick Gundlach, ntg-context
At 02:02 PM 1/28/2002 +0100, Eckhart Guthöhrlein wrote:
>>6) request for improvements. They are probably documented in Hans' privat
>>todo list... I there a need to collect them? I think yes.
>
>
>We would have to decide what wishes should be put on the todo list. I
>think not everything a single person might want to have can actually be
>included, that's why a todo list with priorities would be useful. One of
>the key factors for determining this priority are certainly Hans' own
>needs and projects, so the best place for the list is in his hands - where
>it is.
currently when someone expresses a wish, i kind of decide on the fly to add
it or not; some extensions are just adding a couple of lines, but more
complex wishes, which demand an overhaul (or depend on other work in
progress) go onto the todo list;
i indeed do have a todo list somewhere (stacks of notes) so you may expect
extensions for the next couple of years.
fortunately we have a couple of demanding projects which result in new
mechanisms; unfortunately the docu lags behind then
Hans
-------------------------------------------------------------------------
Hans Hagen | PRAGMA ADE | pragma@wxs.nl
Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
tel: +31 (0)38 477 53 69 | fax: +31 (0)38 477 53 74 | www.pragma-ade.com
-------------------------------------------------------------------------
fall-back web server:
www.pragma-pod.nl
-------------------------------------------------------------------------
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: suggestion
2002-01-28 10:59 ` suggestion Patrick Gundlach
` (4 preceding siblings ...)
2002-01-28 13:02 ` suggestion Eckhart Guthöhrlein
@ 2002-01-28 21:28 ` Daniel Pittman
5 siblings, 0 replies; 16+ messages in thread
From: Daniel Pittman @ 2002-01-28 21:28 UTC (permalink / raw)
On Mon, 28 Jan 2002, Patrick Gundlach wrote:
[...]
> More important is to "rate" the questions:
>
> 1) is it a question to wich the answer can be found in the
> manual? Then there is already a documentation for it and we do
> not need to answer it again.
Heh. My question, about why my table content didn't lay out correctly,
was documented in the manual. Sure, it was my stupidity, but I managed
to miss the vital detail when reading.
The FAQ is an /alternate/ indexing system, as much as anything, for this
sort of question. :)
Daniel
--
As an adolescent I aspired to lasting fame, I craved factual certainty, and I
thirsted for a meaningful vision of human life -- so I became a scientist.
This is like becoming an archbishop so you can meet girls.
-- Matt Cartmill
^ permalink raw reply [flat|nested] 16+ messages in thread