Redmine

I just created the HowTo_Use_Hooks page. Feel free to edit in any way necessary. This is the first attempt to create a more extensive documentation on creating Plugins. The goal should be to have all the common techniques documented (or at least to provide links to good explanations). Equally (or even more) important would be to document all that small and not-so-small APIs lingering in the code.

That way, we could foster the creation of new plugins and keep up the idea of a more modular Redmine. I will try to provide some of that documentation in the next weeks.

And I'm definitely "yay" to a Wiki overhaul. We have some good information already but the visibility of all that is rather low unfortunately. I would love to help to improve that.

--Holger

Holger Just wrote:

I just created the HowTo_Use_Hooks page. Feel free to edit in any way necessary. This is the first attempt to create a more extensive documentation on creating Plugins.

Great, thank you. It's important to understand how the hooks work because there are plenty of edge case bugs with them still.

I've also created a "script" that automates the hook creation, just give it the hook name you want to call and it will create the class/methods and update init.rb automatically. I've used it on my last few plugins and just need to refine it a bit more before I make it public. (It also scripts how to monkey patch Redmine.)

Eric Davis

Hi There,

I've written about 100 pages of documentation on how to use Redmine, for a client who's given the go-ahead for me to share back with the community. It's done in Redmine wiki pages, using some formatting tricks to include a navigation/toc tree in a 'pane' at left on all pages. Not onsite today, but I'll upload a couple of screengrabs tomorrow so you can see what it looks like.

Cheers,

jh

Wow that sounds great! I can't wait to see (and get) what you've got. Newer versions of redmine include the ability to have an editable sidebar (the one on the right). Maybe we can massage your tricks into being there.

Below are some of the screens (the help title page, section heading for reporting & tracking issues, a table showing roles & permissions, and a page of wiki formatting tips). I'm working on copying these pages to another instance of Redmine, so I can sanitize them and send to you (under my name, not my client's).

Cheers,
jh

Using Redmine (help "title" page)¶

!Using Redmine.png!

Reporting & tracking issues (section heading for user procedures on reporting & tracking issues)¶

!Reporting and tracking issues.png!

Roles and permission (developer page with table of permissions)¶

!Roles and permissions.png!

Formatting tips and tricks (developer page with tips & tricks for using Redmine markup)¶

!Formatting tips and tricks.png!

missing the underscores in the filenames there -- but I think it's best to leave them out anyway (too big to embed in a forum posting!)

• most of the screengrabs need replacing — is the generic 'Redmine' project (that everyone has access to) the best example ?
• a lot of the procedures have changed (between what I've documented and the existing instance of the public Redmine.org project) — not sure whether that's because of enhancements to Redmine from Redmine.org, or hacks from my client.

I can spend a couple of hours a week working on this myself, to update the pages to match the latest release, if you want to add me to the project.

Cheers,
jh

You can use redmine.org for sshots, or if not applicable (like you need to update something etc. use ux.redmight.com or demo.redmine.org. If you need admin I will make you admin at ux.

UX.redmight.com is running latest trunk.

If you want to privately share your stuff with me (under NDA or whatever you need) I'd be happy to help speed up the process.

Come by IRC and ping me (nick Khalsa) or you can skype me (sikhnerd) if you see that I'm on and we can chat :)

• I've relied heavily on being able to format the text. The flag for that is: changing self-filter_styles=true to self-filter_styles=false in /lib/redmine/wiki_formatting/textile/formatter.rb. Also, changing to border: 0px ... under div.wiki table in public/stylesheets/application.css
• For screengrabs, demo.redmine.org gives me very random projects, and I would rather not have to recreate a set of representative projects and issues — and ux.redmine.com is cluttered with spam projects and issues. Is there anywhere I could get access to a real (representative but not proprietary) set of projects and issues to capture?
• There's still the issue of how to extract the project (or just the wiki) from my instance, to insert in another. Here, I ended up just cutting and pasting every page between instances. Are there any plans for adding the facility to export and import projects?

Cheers,
jh

That left hand navigation pane is fantastic!

Definitely interested in learning how you did that.

Cheers. Basically it's a table, using the {{include}} and {{child_pages}} macros.

I've lost touch — what's the status of using this for Redmine.org ?