From: Thangalin <thangalin@gmail.com>
To: mailing list for ConTeXt users <ntg-context@ntg.nl>
Subject: Re: Feedback wanted on a ConTeXt tutorial
Date: Sun, 29 Sep 2013 10:50:19 -0700 [thread overview]
Message-ID: <CAANrE7oM5ZtRwYiG1aKCphxujbyS_pWXN5_ja5tnV9Vj3OAN2g@mail.gmail.com> (raw)
In-Reply-To: <CAGbDsP2e_py4es0EFahg+E_Ofm=NL3JakkRtOTKLF2m4y3xx0g@mail.gmail.com>
Hi,
Some feedback:
- The introduction paragraph can be shortened. For example, tell the
reader to "try the subsequent examples using ConTeXt Live web page"
(as opposed to 'almost all of the examples in the series can be run
online'). On any example that does not work, indicate such at the
time.
- "abt 40 euros" is missing "ou".
- "combo" should be "combination".
- "In Windows", "In Mac", etc. can be "Windows", "Mac", etc.
- Use the active voice (it shortens text).
- Avoid using abbreviations and jargon.
As Marco noted, why not apply such wonderful effort to the wiki?
On Sun, Sep 29, 2013 at 8:22 AM, Mari Voipio <mari.voipio@iki.fi> wrote:
> Hello!
>
> Inspired by some informal discussions at the recent ConTeXt meeting I
> started to write a *really* basic ConTeXt tutorial. However, before I
> get further than the first six chapters, I'd like to get feedback on
> it, especially on the content, but also on the layout. The file is (at
> least temporarily) available at
> <http://www.lucet.fi/pdfs/ctxbasics.pdf>.
>
> I know already that there are a few things missing in the existing
> chapters, but I'd like to know if the document is any good and if the
> style is suitable for such a document. I've planned and written it out
> of my own experiences with ConTeXt, so maybe this document could
> become a My Way doc when it is finished (something public domain
> anyway).
>
>
> Thank you,
>
> Mari
> ___________________________________________________________________________________
> If your question is of interest to others as well, please add an entry to the Wiki!
>
> maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
> webpage : http://www.pragma-ade.nl / http://tex.aanhet.net
> archive : http://foundry.supelec.fr/projects/contextrev/
> wiki : http://contextgarden.net
> ___________________________________________________________________________________
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!
maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage : http://www.pragma-ade.nl / http://tex.aanhet.net
archive : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___________________________________________________________________________________
next prev parent reply other threads:[~2013-09-29 17:50 UTC|newest]
Thread overview: 14+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-09-29 15:22 Mari Voipio
2013-09-29 17:05 ` Marco Patzer
2013-09-29 18:26 ` Mari Voipio
2013-09-30 14:06 ` Lars Huttar
2013-09-30 17:15 ` Mica Semrick
2013-09-29 17:50 ` Thangalin [this message]
2013-09-29 18:41 ` Mari Voipio
2013-09-30 7:35 ` Keith J. Schultz
2013-10-01 6:30 ` Mari Voipio
2013-10-01 9:32 ` Mari Voipio
2013-10-02 10:51 ` Keith J. Schultz
2013-10-02 11:28 ` Aditya Mahajan
2013-10-02 12:10 ` Keith J. Schultz
2013-10-02 19:16 ` john Culleton
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CAANrE7oM5ZtRwYiG1aKCphxujbyS_pWXN5_ja5tnV9Vj3OAN2g@mail.gmail.com \
--to=thangalin@gmail.com \
--cc=ntg-context@ntg.nl \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).