D7 Core Image docs

As a new Drupal user coming in with the release of D7 I find that I can NOT find how to add images to pages such that I can mix them with text, etc. I tried WYSIWYG with CKeditor and looks good in edit but images and formatting disappear in view. I am getting frustrated fast....

I would be happy to document but have yet to discover the answer to my problem. At http://drupal.org/node/1040446 I found some info about how to get CKeditor working well.
But I end up with the same issue of seeing my images in editor mode , but in view the content is rendered like in "view source", not as html. See example at:
http://learningdrupal7.info/comment/11#comment-11 where I am attempting to document the whole ball of wax and not making a lot of progress at the moment.
Thanks and Best Regards,
David

This is an important issue to document right to ensure that people are reminded about the need for alt tags.

We definitely need to start with a new document starting with Drupal 7's image handling that is simple & allows people to grasp the basics before exposing them to all of the variations to extend what comes with core.

I've begun the process of updating this section. As a start I created a new page http://drupal.org/node/1089776 designed to serve as the official documentation for the D7 core Image module. This should eventually be the page you are directed to by the URL documentation/modules/image. Currently that URL is associated with current documentation for the contributed Image module for D4-D6 (with a mass of child pages about related modules).

So, two modules with the same namespace. But the D7 Image module is not technically the same module, not an upgrade of, the D4-D6 contributed module.

Do we consider the D7 Image module to the be the official owner of the Image module name and therefore deserves its own separate documentation page? Or should the page at documentation/modules/image contain basic information about both modules (multiple versions) and have separate child pages that delve into the details of working with each?

I guess I'm leaning in the direction of having documentation/modules/image be the official page for the D7 module (which currently owns the namespace, right?) but mention the contributed module (versions) and link to a child section containing the current page with its child pages about image manipulation pre-D7. Right now node/1089776 exists as an incomplete documentation of the D7 module. It just contains a preliminary description of the module.

I'm willing to move forward in the direction that makes the most sense to everyone. Whaddya think?

Clarification: the current node that includes D4-D6 Image module documentation is http://drupal.org/node/22395

just starting to work on this - collaboration welcomed! (best to reach me via the contact page)

I've posted a basic description of default image handling in Drupal 7 at http://drupal.org/node/1089776 - let me know of any feedback on this bare beginning.

Obviously image handling is a big topic that covers a lot of territory. There are fragments of good documentation scattered around d.o that can be incorporated. I'll clean up my initial notes and share them.

Hi Arianek

Understood - just saw your note (after posting update in #14 - guess it's late); will make modifications per your suggestions.

Thanks!

Kay V (aka ownsourcing)

@Arianek,

I don't seem to have permission to delete http://drupal.org/node/1089776, but I've given a first stab at reorganizing/incorporating per #13.

It's possibly worth noting before you delete it that among the revisions, node/1089776 included several previous versions of some brief/incomplete documentation.

There are a number of version-specific pages that still need to be incorporated.

battle plan:

1. merge the information on:
- http://drupal.org/documentation/modules/image
- http://drupal.org/node/1089776
- http://drupal.org/node/895548
- http://drupal.org/node/528074
(also make sure to include the info in the core help text covering images)
note: merging implies deleting the pages whose content was merged into another page

2. move D6 and earlier instructions to child under http://drupal.org/documentation/modules/image (with decent references in main article)

3. restructure other child pages (see if they go under D6, maybe delete some outdated info)

4. rewrite, improve, complement http://drupal.org/documentation/modules/image
the hardest part i guess. i ll need to dice in D7 and actually learn (yikes) how image stuff works nowadays ;)

I think I can do step 1,2 & 3 this week and do 4 during the coming weeks ...

let me know if you disagree with the approach

3 page containing D7 info are merged:

http://drupal.org/documentation/modules/image
http://drupal.org/node/895548
http://drupal.org/node/1089776

afaik these can now be deleted:
http://drupal.org/node/895548
http://drupal.org/node/1089776

im working on moving all D6 info to:
http://drupal.org/node/528074

someone, hopefully not me, has to move all the children of http://drupal.org/documentation/modules/image under http://drupal.org/node/528074

actually, what I say in #22 is not true

someone, probably me, has to figure out which of the children are D6 only , before moving them ... :(

all D6 info now moved to http://drupal.org/node/528074

a poor soul, hopefully not but probably me, should now figure which of the info on that page is still valid for D7 and then move it back :'(

other todos:

* review http://drupal.org/documentation/modules/image
* http://drupal.org/node/528074
* manage (move, remove) children of both pages

* all D6 related children of http://drupal.org/documentation/modules/image were moved to http://drupal.org/node/528074
* there were no child pages that contained D7 information (all child pages were related to the image module which wont have a D7 release)
* some child pages werent very informative, so another round of reviewing all child pages is necessary
* the book structure under http://drupal.org/node/528074 is now quite a mess, so a lot of work remains in sorting it out
* the comment on http://drupal.org/documentation/modules/image can be rolled

review http://drupal.org/documentation/modules/image is done

@arianek please review it as well as I'm very good in overlooking my own typos and other errors

although i think i covered all image functionality in D7 (image field settings could have been covered in more detail), i think he page could use technical review as well

I think your proposal for the restructuring in #29 is okay.

When they are placed in that new location we can review those subpages one by one.

A bunch has changed since 2011. I'm going to mark this as closed but feel free to re-open.
https://drupal.org/node/22395/revisions/view/1740966/6840653