Feature Request #1916

Proposal to improve the formatting, structure and content of Kohana Projects

Added by Dave Stewart over 5 years ago. Updated about 5 years ago.

Status:ClosedStart date:08/07/2009
Priority:NormalDue date:
Assignee:Woody Gilk% Done:

0%

Category:Kohana Website/ServerEstimated time:1.00 hour
Target version:-
Resolution:fixed Points:

Description

At present, the Projects Wiki is difficult to read due to the body CSS, and probably less that 25% of projects have any wiki documentation. Of those, only a few have anything near approaching complete documentation due mainly to the difficulty / lack of knowledge in writing and structuring.

I propose that this be tackled in 3 stages:

1. Update the CSS to make the content readable
2. Write a Wiki Documentation 101 giving project creators a head start in documenting
3. Use the Documentor project to encourage people to write quality documentation offline then convert it online.

For the first stage, I've spent a fair amount of time crafting an updated set of styles and a demonstration suite that show how it works, and how it could be a lot clearer.

http://www.keyframesandcode.com/resources/php/kohana/wiki/

It comes in 2 parts:

1. An Introduction showing the general design and formatting decisions
2. Examples, with the option to toggle styles between before and after.

Implementation is as simple as adding the stylesheet reference to the main application.css file.

Once implemented, I can finish off Documentor and it should be fairly trivial to get a Kohana Project Docmentation 101 written.

I'd like to take this opportunity to say I'd like to officially offer my time to get more involved with the web / documentation side of things if required.

Cheers,

Dave

wiki.css Magnifier (6.63 KB) Dave Stewart, 08/14/2009 02:23 PM

wiki.css Magnifier (7.35 KB) Dave Stewart, 08/14/2009 02:30 PM


Related issues

Related to Kohana v2.x - Feature Request #1906: Small css change for Redmine Closed 08/04/2009

History

#1 Updated by Oscar Bajner over 5 years ago

Dave, would you please attach your patch (wiki.css) directly to this ticket.

Do I understand correctly, the stylesheet may be applied without affecting the existing wiki layout, but to take affect, some small changes to the page markup is required?

I don't see any reason why this proposal should be turned down.

#2 Updated by Dave Stewart over 5 years ago

Hi Oscar,

That's great news!

No changes to the markup are needed; what I've done is to implement some CSS combinations that result in modified formatting that should be advantageous to the reader.

http://www.keyframesandcode.com/resources/php/kohana/wiki/formatting/modifiers.html

For example, using b tags inside H3 tags will turn the tagged text red (whereas otherwise the bold tags would have had no effect on already bold text). This could be useful for things like making method namss stand out when documenting a long list of class methods.

The new stylesheet is attached. As I said, I think I've tested it as fully as possible, but if it has any ill effects in once you're done, I'll fix and re-update this request.

Thanks again!

Dave

#3 Updated by Dave Stewart over 5 years ago

Apologies Oscar!!

THIS is the latest file, attached :)

#4 Updated by Ben Rogers over 5 years ago

great css, i like it. but why have this in there?

html {
overflow:scroll !important;
}

#5 Updated by Dave Stewart over 5 years ago

Controversial one this I suppose.

"!important" may not need to be in there (maybe I had to override it?), but I set the html to scroll so that when you go from a short page to a long page, or vice versa, you don't get an annoying shift to the left or right of all the content as the scroll bars come up.

A lot of the projects pages are of varying length, so it makes sense I think.

(The scroll track will display benignly all the time, and the bar will only show when the page is long enough)

#6 Updated by Ben Rogers over 5 years ago

that makes sense, i guess my only complaint is the bottom scrollbar, maybe overflow-x: scroll !important ???

achieves the same effect with out having a benign scroll bar at the bottom for 9 out of 10 pages

#7 Updated by Dave Stewart over 5 years ago

Ah, you mean overflow-y ?

In theory, the page shouldn't show H scrollbars if the content is less that about 98%. Maybe it needs some tweaking? Whoever is going to implement it might want to tweak the #content width and #sidebar width % settings too

#8 Updated by Dave Stewart over 5 years ago

Not sure when I should expect an update on this. How do things work around here?

#9 Updated by Dave Stewart about 5 years ago

Is this ever going to be implemented? The current projects is pretty unreadable.

#10 Updated by Woody Gilk about 5 years ago

Refresh the page! Implemented as part of the new v3.0 style.

#11 Updated by Woody Gilk about 5 years ago

  • Status changed from New to Closed
  • Assignee changed from Jeremy Bush to Woody Gilk
  • Resolution set to fixed

Refresh the page! Implemented as part of the new v3.0 style.

Also available in: Atom PDF