Scheduler has a couple of pages in the drupal documentation site building guide http://drupal.org/node/108984
Should we link this from the modules main page? If so, how much should be repeated back here?
Do we know if many users read those documentation pages? If not many, then should we keep most of the documentation here, is it ok to duplicate?
If duplicating, maybe we should have the pages formatted so that we can simply copy from here to there, rather than have to edit and make changes twice.

By the way, it says that I created those two pages, but I think that it wrong. If you look at the revision history I started contributing in the middle, but the first text was written by other users. Odd.

Jonathan

Comments

jonathan1055’s picture

Title: Scheduler documentation page » Scheduler documentation

We also need to update the readme.txt file to include notes on calendar integration for D7, what hooks scheduler provides for custom interaction with other modules, what integration we provide by default, the current maintainers, and updated installation notes for both D6 and D7

The project front page to usefully include some of this information too.

jonathan1055’s picture

Issue summary: View changes

typos

jonathan1055’s picture

pfrenssen’s picture

Great stuff, I have put it on the project page, and tweeted about it. Congratulations on your 7th Drupal birthday!

jonathan1055’s picture

Thank you for doing that, and thanks for the telling me about my birthday, I had not noticed :-)

pfrenssen’s picture

The request to link the documentation on the main project page has already been adressed: it is linked as "Read documentation" underneath "Resources" in the sidebar.

So we still need to work on the readme.

jonathan1055’s picture

Now we are nearing 7.x release 1.2 what tasks do we need to do for documenting? Should we create a changelog.txt file? If so, does it just have a copy of everything in #2032911: Enhancements for 7.x-1.2?

pfrenssen’s picture

I don't think we need a changelog. This information is already readily available in the git history, the release notes, the commit list, ...

I would certainly copy the list of #2032911: Enhancements for 7.x-1.2 to the release notes though.

jonathan1055’s picture

OK that's fine with me. I will try to find some good practice guides for readme.txt and update it.

malcomio’s picture

Version: master » 8.x-1.x-dev
Issue summary: View changes
Status: Active » Needs review

Not sure if this issue needs to be open any more.

I've created a guide at https://www.drupal.org/docs/contributed-modules/scheduler - it would be good to link to this from the module page.

jonathan1055’s picture

Hi malcomio,
Thanks for doing this. I presume you migrated the content from the exitsing doc page https://www.drupal.org/node/108984 ?
That has not been changed for a while, and was out of date. For example, the video by Heather James no longer exists, but we do have a D8 video (see project page).

There are a few other bits which need updating, but I can do that. First I will link it from the project page.

jonathan1055’s picture

Also, did you create that page as 7.x or 8.x? The links on the project page have versions attached.

malcomio’s picture

Yes, I'd started from that page, and adapted it for D8.

I hadn't checked the video links - I've updated it.