Right now, this style sheet is a draft, and not open to anyone outside User Services and OLI/FacTS. The purpose is to create a set of guidelines for creating Confluence content that can be the basis for campus-wide use, tutorials, workshops, and so forth. This will be a set of best practices to encourage standardization of Confluence content around proven styles, arrangements, and use of macros. ITS pages should model this these practices as far as possible.
We want campus users to basically generally follow these standards because:
...
- We are selling the internet as a diverse, flexible and versatile way of conveying content and promoting engagement. Telling people they must follow a strict style guide offers them much less incentive to bother with it. (Simply touting the efficiencies of paperless communication has a poor record for on-boarding ordinary users to digital technology, for various reasons.)
- We will need to police this, occasionally telling people they "must" change their sites, and "must not" deviate. The more of these kinds of this conversations that happenshappen, the more disaffection we can anticipate among users.
...
- offer tutorial content showing the basics of building attractive content: technical as well as design considerations. We sell standardization as a program for making content effective: follow these standards, and your content is effective. You don't need spend time learning more.
- develop a series of videos showing how to use the basic features to build content. In one-on-one sessions or workshops these are the features we demonstrate.
- indicate that other, "more advanced" features are available, but should only be used with a thorough commitment to testing (time and effort). We We can assist with this process.
Developing a best-practice stylesheet will require testing to ensure consistency and reliability of macros, markup, or content arrangement. Below are various features we should consider:
Headings
Headings are easy to explain. The Table of Contents Macro is also easy to explain, and draws from uses headings. I recommend this as a basic element usable by all users.
Panels
Panels are easy(ish) to explain, and are a quick way for users to have produce callouts that are brightly colored (unlike tables, which are limited to pastels).
Tables
Tables as standard form of organization, especially for tutorials. Recommended.
Testing:
- Android: Chrome browser. Tables usable. Look OK
...
- .
Columns
Page Layout: Confluence displays columns within sections one after another in mobile. Thus, two parallel columns in desktop are delivered left over right.
I do not recommend columns, because they are in one way or another complicated. Yes, they work in mobile, but they require a level of attention to testing that most users simply won't bother with. Several ways to use columns. They aren't necessarily difficult to construct, but they complicate views on various devices. I see this as an advanced feature, not recommended for most users.