GHOP #19: Make a "personal site" recipe

This is re-opened since ja...sudo2.com had to withdraw.

Claimed by dallas.evers (don't know d.o username)

Do I have to use Drupal 6 or I can use Drupal 5? some modules don't have Drupal 6 port yet.

cool xD
Do I have to teach the reader everything? like for the about page, user have to post something. How to post a item and how to configure the post suppose to be explained in the handbook.
Should I just list the modules, show people how to configure them, then show a example of how to use them for a personal site?

Finally, I wrote the post.
http://mgccl.com/2007/12/13/step-by-step-build-a-personal-site-with-drupal
if I have a video, I would post in drupal.org's videocasts.
this is a article.. should I post in the how to section in the handbook.?
and I just found out I suppose to annotate the images, guess i would leave it to tomorrow.

Marking for review.

Mgccl, once we approve it, you can add the page to the Site Recipes section of the handbook: http://drupal.org/handbook/site-recipes

I took a look and here are my comments:
1. When this becomes a handbook page, you'll need to pay attention to the handbook style guide at http://drupal.org/node/22299. For example, to designate menu paths, you use '->' but should use '>>'.
2. The grammar is pretty rough in places. I suspect you are not a native English speaker? If that's the case, that's ok. I'm sure others can help clean it up some.

As far as content goes, this seems about at the right level for the task. It does go through everything in the requirements and has lots of screenshots. On some of the screenshots it might be helpful to annotate them (for example, to circle certain text fields or features that you are emphasizing).

I think this is probably ready to add to the handbooks section, so I'll set the issue to code needs work. Once you add the handbook page let us know and we'll take a look at that and let you know if there is anything else that needs to be taken care of.

Good job!

The pre-req mentioned at the start help lay the foundations for the intended audience. (We should probably have this style as a template for 'How To articles at some point). When you move it to the handbook, drop mention of item 4, the English is clear enough to follow and can be edited/cleaned up later.

Other then Gallery (which I don't use), by following the instructions I was able to create the site as instructed. It has the added benefit of show casing a 'method' using CCK to create a 'review' to move beyond that if a given site later has a need for that flexibility.

If you can deal with aclight's item #1, we can deal with item #2 after it gets moved to the handbook.

ok, almost done with 1.
But there's a problem on posting on the handbook, it does not allow upload pictures or use the img tag.

I think you need to be a document maintainer to use the image tag, and then you need to select the input format fieldset just under the body text area and choose documentation.

For image uploads, I think the desired method is to attach them to the node as file attachments. After you save the node, you'll be able to get the URL of the files stored on d.o, and then you can edit the handbook page and put in the proper URLs for the IMG tags.

aclight is correct. Mgccl, you can ask to become a member of the docs team or you can put in what you have and leave adding screenshots to the docs team. Either will be sufficient for your task.

ok, I have published the recipe
http://drupal.org/node/201271
For the images, please check http://mgccl.com/2007/12/13/step-by-step-build-a-personal-site-with-drupal , some of the images added annotation, refresh the browser cache to see them.

Just a quick comment on this line:

To set up a personal site with Drupal, you have to download Drupal, install it, and then add these modules:

That needs to be clarified to be clear this is just an example of a personal site. It makes it sound as though every personal site _must_ have these modules which is obviously not true to anyone who's used Drupal before but may be confusing to someone who just found Drupal. Especially as Gallery 2 is a huge separate application which, IMO, is not needed for most personal sites.

Michelle

Awesome, I am going to mark your Google task complete. I am setting this to RTBC so that docs team can get the images in there for you and maybe run a grammar clean up.

Thanks for your work on this!

I've added all of the images to an issue at http://drupal.org/node/201352.

I've also now added links to the locally hosted images in the body of the handbook page itself. Grammar and formatting of the text still needs a little bit of work.

Updated the component to reflect the new status. Changed the component to reflect the new component categorization. Started with cleaning up html tags, grammar and punctuation to the handbook page in discussion (http://drupal.org/node/201271).

John
-----------------------

Drupal Norge
_{Det offisielle norske nettstedet for Drupal}

Fixed the page a bit but the page still needs work (grammar, html, punctuations).

John
-----------------------

Drupal Norge
_{Det offisielle norske nettstedet for Drupal}

unassigned