Using WebDAV with Vista
As all projects include a WebDAV-based file share for non-repository files, we have of course also made a 'Help' page with information on how to connect. It turns out that the how-to section for 'Windows' was XP-only. Vista does this differently, and a plain Vista install even needs a fix to get it working.
We have just updated the Help page with a new 'Vista' section - look it up inside your project Help (HelpUsers/Files) to get started with WebDAV on Vista.
Keyboard Navigation in Browse Source
If you use 'Browse Source' in projects regularly, you may be interested to know that you can use the keyboard to navigate.
Use:
- 'J' to move down.
- 'K' to move up.
- 'O' or hit 'Return' to open and close folders, and to open files for reading.
Introducing InterWiki
Many of you (if not all of you) have relations to other systems while developing and maintaining your CodeResort project. Tickets, Wiki pages, Subversion log messages and so on fills up with full links to external systems.
It may be that you use some other bug tracker, or perhaps reference pages on test or production systems that showcase a bug. It could be anything. What makes these links a bit difficult is that they often are:
- Difficult to read and reference
- Don't get updated when a system moves from one address to another
- Not pretty
InterWiki makes it possible to build your own link syntax. In the same way you can link to a wiki:WikiStart (wiki page) or ticket:42 (ticket), you can now make a link that looks and behaves just as you need it.
Say for instance that you have a test and production setup and your project also deals with bugs on pages and content planning. If the content pages are numbered, how about referencing them as prod:525 or test:233?
If you use some other bug tracker with your project, how about just typing bug:123 and have a full external link rendered?
Or, if your project uses modules from another project, such as the epicode project that you need to reference, how about typing epicode:ticket:42 to make a link? Even display this link as descriptive text by using this pattern: [epicode:ticket:42 related issue]
Want to know how? Read up on the HelpUser/InterWiki help page - you'll find all you need to get started.
Saving Custom Queries as Reports
Thought I'd drop a note on yet another new feature that is easy to miss - a very useful feature for anyone using the Ticket system.
Projects contain two types of ticket listings. The listed Reports used to be SQL only. Anyone looked at the SQL or tried to modify or make new SQL-based reports? Not as easy as anyone would have liked.
Custom Query on the other hand is great for picking the criteria of the selection, selecting grouping, ordering and also what columns you would like to display. However, unless you set them up as [query:] links or inline using the [[TicketQuery]] macro, they were temporary.
No longer. This button is now available on Custom Query pages:
Saving a query as a report makes it appear on the 'View Tickets' front page, and allows you to link to it using the report syntax: {10} or report:10
Much nicer don't you think?
Annotate (Blame) for source code
One of the recently available features is the ability to annotate the source code - most commonly called 'blame' support due to it's popular use of finding out who (and when) and error was introduced...
When browsing a source file, there is now a new 'Annotate' option:
Selecting it will render the changesets for each line, and the tooltip will provide some basic information - selecting the changeset will take you directly to it:
Ain't that nice?
Quick Links in Search field for easy navigation
Here is a tip for quickly navigating to a resource when you know its name. Just enter it as a link in the 'Search Project' field.
Here are some examples for you to try in your own project:
- #42 - ticket number 1
- [42] - for changeset 42
- {3} - for report number 3
- RecentChanges - for wiki page of that name
Pretty much all resources in your project is directly linkable - have a look at the HelpUser/Links help page to see the possibilities and review syntax.
Blog feature available for all projects
Every project on CodeResort now has a Blog:
- Regular projects (/p/projectname) have a project-internal blog, available to project members only.
- User projects (/u/username) have a public blog for anonymous access - open to the world.
Blog for regular projects
The Blog is enabled by default for all projects, but only project administrators will actually see it due to their extended permissions. To let other in you need to set permissions. A typical setup based on our default permission setup is:
- Grant BLOG_MODIFY_OWN to members ('@member' group) so they can view all the news, post their own news, but not modify the news of others.
- Also, grant them BLOG_COMMENT permission so that the project members can comment on blog posts.
Why a project blog? Our motivation for this feature was to find a nice and simple way to bring any kind of 'news' into the project information - and documentation. It fills a much needed gap for information that does not fit nicely into either wiki, tickets, or changeset messages. We can't tell you how you should use it, but here are some ideas for inspiration:
- News on project organisation, introducing new project members or new responsibilities.
- Project deliveries such as releases / deployments and changeovers, announcing branches and the like.
- Pulling together a number of tickets, changesets and wiki updates into a coherent overview of what has actually happened and why.
- Notes on changes to developer setups, dependencies or similar information needed for people to do their work.
The blog has its own RSS feed for full-length messages, and it also puts all creations, edits and comments into the Timeline. Note that if you already have a Timeline RSS feed set up, you need to grab the URL again to get the blog events (blog=on needs to be added to the query string).
Try it out, and see what it can do for you and your project.
Blog for user projects
Having the blog feature available, we thought it would be a great idea for any user with their own project to also have a blog to share their findings and thoughts with others. The user project blog is all pre-configured and ready, so just get started posting.
Note: If you have a login but no user project, you basically only need to click 'Create Profile' in the top navigation menu. Fill in the form, and your own personal mini-project is created. Currently a 'user project' has the following main features:
- A Wiki, only available for you.
- 'My Tickets' - your own overview of all open tickets in all projects on CodeResort where you are somehow involved.
- The Blog that is available to the world.
If you do start using your personal blog, let us know so that we can add a link to your blog in the sidebar here.
More Information
We've also added a help page with further information about the blog - see 'Help' form inside your project, or read the wiki page here if you are logged in: HelpUser/Blog
Open Source
Lastly, just a note to say that the blog feature is made available as open source - developed and maintained by CodeResort: http://trac-hacks.org/wiki/FullBlogPlugin
This is done to ensure that whatever data you enter into your project here at CodeResort, will also be available and accessible if you for some reason should want to move your project away from CodeResort later.
Feedback?
Do you like the blog? Does it make sense? Do you have requests for changes or new additions to the functionality?
We made it for you, and appreciate any help you can give us in making this a useful feature.

rss