[documentation] [Documentation feature] Adding images to handbook

[pnm]

Issue status update for 
http://drupal.org/node/89377
Post a follow up: 
http://drupal.org/project/comments/add/89377

 Project:      Documentation
 Version:      <none>
 Component:    Misc
-Category:     support requests
+Category:     feature requests
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  dvessel
 Updated by:   pnm
 Status:       active

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




pnm



Previous comments:
------------------------------------------------------------------------

Mon, 16 Oct 2006 01:44:38 +0000 : dvessel

I want to add an inline image for a handbook entry. Found the image
submission guide line [1] but there's no way of embedding the image. img
tags are disabled and there's no way to upload it. Am I supposed make a
link from another site? I hope not.


That page should be more clear about how your expected to submit an
image.


[1] http://drupal.org/node/762




------------------------------------------------------------------------

Mon, 16 Oct 2006 01:53:38 +0000 : Michelle

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




------------------------------------------------------------------------

Mon, 16 Oct 2006 17:09:11 +0000 : dvessel

Thanks for the explanation. I wonder what the holdup is. Illustrating
handbook pages would be a big help to everyone.


Is there an archive of the discussion around here. I'm not really
interested in subscribing to the documentation mailing list.




------------------------------------------------------------------------

Mon, 16 Oct 2006 19:10:12 +0000 : pwolanin

Attachment: http://drupal.org/files/issues/Screenshot_13.png (177.38 KB)

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?




------------------------------------------------------------------------

Mon, 16 Oct 2006 19:17:59 +0000 : pwolanin

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




------------------------------------------------------------------------

Mon, 16 Oct 2006 19:27:10 +0000 : greggles

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.




------------------------------------------------------------------------

Mon, 16 Oct 2006 19:55:05 +0000 : pwolanin

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?




------------------------------------------------------------------------

Mon, 16 Oct 2006 19:57:32 +0000 : greggles

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).




------------------------------------------------------------------------

Mon, 16 Oct 2006 22:01:07 +0000 : dvessel

What is it about issues that allow file uploads? If it was possible to
upload /only/ to Handbooks from /any/ contributor, would the maintainers
allow it? What are they being cautious about? Or is this just a
technical matter?




------------------------------------------------------------------------

Tue, 17 Oct 2006 00:38:41 +0000 : sepeck

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




------------------------------------------------------------------------

Tue, 17 Oct 2006 02:01:27 +0000 : pwolanin

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.