Talk:Documentation/UserGuide/Writer/Intro/Content

From Apache OpenOffice Wiki
Jump to: navigation, search

Progressive Disclosure and Level/Nature of Details

I was looking at this page to become more familiar with the procedures here and how the development of content progresses.

Two questions came to mind.

  • First, is it important to engage in progressive disclosure better? I was thinking of this because of the discussion of borders and also the introduction of the Web View on this page. I am thinking about newcomers to this documentation that do not have much technology-oriented knowledge. It would be useful for the more experienced to be able to deep dive, and for people who visit looking for more details to find them, without creating a situation where visitors may be unsettled by the terminology and concepts that are unknown to them. Has there been much thought to this?
  • Secondly, I am puzzled by the use of "borders" for the framing that happens in the UI presentation of the document material. Since there are actual, drawn borders that can be introduced and shown, it would be good to use a different term for the all of the frames that delimit structural features of the document that are not part of the presentation of the document on a printer, in a PDF, etc. I would also not say too much about frames at the top level, but perhaps a cross-reference would be useful later.
--Orcmid (talk) 23:29, 20 January 2016 (UTC)

Digital Signatures

  • It would be useful to have a status line that shows the digital signature icon in place. I can provide one of those if necessary. It might be useful to indicate what happens when a signature is not verifiable.
  • The note about digital signatures seems to be in the wrong place. We don't even know that the reader knows what one is or what is significant about this statement. An alternative explanation might be "The symbol shown indicates that the document was digitally signed when it was created and that signature has been verified for the document now being viewed." I think any further details need to be in a deeper section (and I don't know enough about this material to make a better suggestion just yet, but it should be in a common place about protections, signatures, and encryption for all of the AOO components).
--Orcmid (talk) 23:56, 20 January 2016 (UTC)
Personal tools