Adding images to handbook

I suspect these docs are simply out of date as they are over a year old. You need site maintainer access to add images but not everyone doing docs is a site maintainer anymore. There is currently discussion going on about how to let module/theme maintainers add screenshots and I guess this would need to be covered as well.

I'll leave the decision of what to do about that page up to the higher ups, but I figured I'd at least explain why there are docs when most people don't have access. :)

Michelle

Ok, here's a test and possible workflow. Since the handbook editor role can use <img> tags, can images be uploaded as attachements to a documentation issue, and then linked in the handbook by an editor?

So, this seems to work- I can link to the screen shot I posted above on a handbook page using the "full html" input format. Does this make sense as a mechanism? The uploaded files for issues seem to be stored in a separate subdirectory:

http://drupal.org/files/issues/Screenshot_13.png

I think a better place than on issues is in the image galleries: http://drupal.org/image

If we need new galleries to hold the images then we can always ask for them to be made.

Well, that would be a better place, but the problem at hand is that of letting typical handbook contributors add images if needed. As far as I can tell, I can't add images to those galleries (even with the editor role). All users can attach images to issues, however.

So, are you proposing to give all users permission to post image nodes?

Suggestion withdrawn, then.

I personally think we should allow all CVS contributors and Documentation maintainers the ability to 1) upload images to image gallery and 2) add <img> tag to posts, but I haven't be successful in convincing others of that viewpoint (not that I've tried that hard).

If you have file upload rights, you have them on all nodes that allow them.

Allowing uploads is essential to the functioning of the project/issue system. But given that screen shots are upload infrequently, theuploading of images is relatively dispensible.

I think part of the problem with the handbook is that is is often read as being authoritative, while it may not be (especially recently when the moderaiton has be removed). Since images and other uploads may be harmful, yet the handbook (as opposed to issues) is often brosed by newcomers, I think there is a valid concern about the security tradeoff.

Perhaps allowing all users to upload image nodes to the gallery, but still restricting img tags to editors and maintaiers would be a better tradeoff than the current situation. This is not realy any simpler in terms of the workflow I suggested above, it just leaves the images in a gallery rather than attached to an issue.

I just marked http://drupal.org/node/103222 as a duplicate, but it contains some discussion as well.

Hi, responding to the duplicate issue report, http://drupal.org/node/103222, I updated the page suggested in the opening of this issue report, http://drupal.org/node/762 "Screenshots" on Jan 12 (but never closed out the issue).

I'm marking this as "code needs review." The guidance is now there. If it's not correct, then please either fix it or re-open this issue. (or if the img tag should be explicitly explained, which I felt was overkill)

It seems that some people may want an 'improved' capability, which may be why I didn't close out the issue previously.

@pnm, thanks for climbing on board and offering all the good suggestions and help!

karldied, thanks.

Images in handbooks are still cumbersome, I am afraid. If a page had a few different screenshots as part of one procedure, the reader would have to go back and forth between the images and the handbook page; it deprives a reader one of the most important parts of a learning sequence- context.

Wish I could think of a constructive suggestion...

Marking this issue as fixed. Summary:

U: http://drupal.org/node/81586
T: Expanding Image Support for Documentation Contributors
Status open; currently about image formats, but could also be taken to mean upload process.

U: http://drupal.org/node/89377
T: Adding images to handbook
This issue, abt how to add images; doc updated 1/12; marking as fixed.

U: http://drupal.org/node/103222
T: Adding images to handbook pages
Dupe of 89377, moved to 'fixed' by sepeck.

In other words:

* Screenshot image addition to handbooks now covered in 762
* Image formats under discussion in 81586
* Image upload process and rights may be under discussion in 81586