shana / google-highly-open-participation-mono

Automatically exported from code.google.com/p/google-highly-open-participation-mono
0 stars 0 forks source link

Write a C/C++ Tutorial for MonoDevelop #40

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
The MonoDevelop IDE is coming up for a release and is sorely in need of
documentation for new users. The page at
http://monodevelop.com/Documentation contains a list of planned topics for
tutorials; the contestant should pick one and complete it.

Timescale: 2 days

Requirements: a detailed tutorial for one of the proposed topics, including
step-by-step instructions and screenshots, written in MediaWiki format.

Original issue reported on code.google.com by m.j.hutc...@gmail.com on 7 Dec 2007 at 2:10

GoogleCodeExporter commented 9 years ago
Forked from
http://code.google.com/p/google-highly-open-participation-mono/issues/detail?id=
28
for  entereczek

Original comment by m.j.hutc...@gmail.com on 7 Dec 2007 at 2:10

GoogleCodeExporter commented 9 years ago
You're welcome to use the Creating_A_Simple_Solution document as a basis for 
your
work, though I'd expect something a bit longer, maybe mentioning things like the
compiler options panel and the class pad.

Original comment by m.j.hutc...@gmail.com on 7 Dec 2007 at 2:14

GoogleCodeExporter commented 9 years ago
I attached Creating C/C++ Projects. In txt file there is tutorial in MediaWiki
format. I'm open for suggestions and if you find any mistakes or anything to 
correct
just post here.

Original comment by enterec...@gmail.com on 9 Dec 2007 at 11:14

Attachments:

GoogleCodeExporter commented 9 years ago
And one more thing. If I complete this this task, can I write another tutorial 
as a task?

Original comment by enterec...@gmail.com on 9 Dec 2007 at 11:17

GoogleCodeExporter commented 9 years ago
Yes, you can write another, when we've ironed the bugs out of this one :)

Could you please:
1) re-create the screenshots with the Gilouche GTK theme, for consistency with 
our
other tutorials
2) demonstrate simple code completion
3) demonstrate use of a pkg-config reference to a system library, and briefly 
explain
why pkg-config is useful
4) mention that C/C++ projects can be included in Mono projects, and why this is
useful (P/Invoke a C library for performance, or to access C++ libraries etc).

If you could actually demonstrate a P/Invoke that would be awesome, but not 
essential.

There are a couple of problems with the grammar, but since English isn't your 
first
language I won't worry too much about those. I'll edit it at the end and send 
you the
corrections. However, I do suggest using a spell-checker :)

Original comment by m.j.hutc...@gmail.com on 10 Dec 2007 at 7:12

GoogleCodeExporter commented 9 years ago
Ok, I fixed those problems, but I had problem with P/Invoke, cause I haven't 
used it
yet and I didn't want to write about sth that I don't have a clue about.
I also fixed some misprints.

Original comment by enterec...@gmail.com on 10 Dec 2007 at 9:34

Attachments:

GoogleCodeExporter commented 9 years ago
I've edited the tutorial and put it up on the MonoDevelop wiki:
http://monodevelop.com/Creating_C_and_CPP_Projects

I'm a disappointed that the GUI/references section and the code completion 
section
were totally un-integrated with the rest of the tutorial. I also noticed bits 
of text
that had been cut and pasted from elsewhere -- though we can use the ones from 
the
MonoDevelop wiki, I'm not so certain about the GTK+ code, and any text taken 
from
other websites would have to be checked. Could you list all of your sources?

Original comment by m.j.hutc...@gmail.com on 12 Dec 2007 at 1:46

GoogleCodeExporter commented 9 years ago
here's a new, simpler code for gtk+ code, based on 
http://www.gtk.org/tutorial/c39.html
And yes, I copied some fragments from other MonoDevelop wiki articles(like
introduction to classpad). And I also used one sentence about pkg-config from
wikipedia, cause I didn't know how to simply express it in English.

Original comment by enterec...@gmail.com on 12 Dec 2007 at 10:48

Attachments:

GoogleCodeExporter commented 9 years ago
oh, and I noticed some mistakes in current version
"To do this, we*;*ll need *ot* use the GTK+ GUI library."
and
"provided by pkg-config, which provides a unified interface for querying 
installed
libraries for the purpose of compiling software from source." -> I think it 
would be
better to replace "provides" with "gives"

Original comment by enterec...@gmail.com on 12 Dec 2007 at 10:54

GoogleCodeExporter commented 9 years ago
Good catches. 

Well done, I'll mark the task as complete.

Original comment by m.j.hutc...@gmail.com on 14 Dec 2007 at 11:56