HTML Logo by World Wide Web Consortium (www.w3.org). Click to learn more about our commitment to accessibility and standards.

Moving forward with Composr

ocPortal has been relaunched as Composr CMS, which is now in beta. ocPortal 9 will be superseded by Composr 10.

Head over to compo.sr for our new site, and to our migration roadmap. Existing ocPortal member accounts have been mirrored.


Is there downloadable documentation packs available- tutorials, dev guide, etc.?

Login / Search

 [ Join | More ]
 Add topic 
Posted
Rating:
#34565 (In Topic #7793)
Avatar

Community saint

documentation dev tutorials download

Hi, new to OCPortal and am trying it out. If it works out, I'll be purchasing a "lifetime" subscription as soon as I'm confident of it.

I'd first like to say that the developer focus on user-friendly features is not just outstanding, but unparallelled. I've never seen software with so much thought put into how it will be used and what the needs of the user will be in working with it. It was also a brilliant idea to link the tutorials directly to the admin panel - it reminds me of an enhancement to a company's online procedure system that I implemented once, where I linked the training manuals for each procedure directly to the procedure step so they could 1-click to it. Only better of course, since you have real tools to work with and I just had Word, their web-based documentation system and my web knowledge to puzzle out their linking system :)

That being said, I am hoping to find the advertised downloadable packs of the tutorials and dev documentation for one very significant reason- it seems that I cannot always access the OCportal documentation via the Internet in a reasonably timely manner. I get many failures and slow loads, and this is severely affecting my productivity and confidence. I was well aware that I would have to modify OCPortal (esp. theming) when I decided to evaluate it, but if I can't get the information I need to work at full speed, that is a real problem for my project.

Could you let me know if there's some way to obtain this? I've tried using IE to save your tutorials and dev guide as offline content from the printable screen, but since the pages are all PHP, it's difficult to tell if it worked or not. Given what I know of this "feature" of IE, probably not :(

Thanks in advance for any help!

David

Back to the top
 
Posted
Rating:
#34568
Avatar

Community saint

I am NOT staff so you won't get a 'definitive' answer from me, but I think this has been asked in Forum previously and been answered. To summarise:
  • Docs are linked to ocPortal so that 'volatile' documentation is always up to date
  • Docs that are standardised are linked via the website

toccms said

… it seems that I cannot always access the OCportal documentation via the Internet in a reasonably timely manner. I get many failures and slow loads, and this is severely affecting my productivity and confidence.


This is only a recent occurrence. Previously the ocPortal server has been pretty solid, but I can understand that you are experiencing some frustration in having to wait for a slow-load, or one that doesn't load at all. I have mentioned this in another thread unrelated to this topic.

I am sure the staff will respond with a more definitive answer.

BTW - Welcome aboard!

Take my advice. I'm not using it!

View my working ocPortal site (version 9.x.x) at Anglo-Indian Portal
Back to the top
 
Posted
Rating:
#34569
Avatar

Community saint

Thank you Fletch. I'm hoping that at the worst, I'll be able to self-download or self-print (to PDF) the tutorials as a single file. (Edit- found via the SiteMap that my site has the Dev Guide already, so that's not needed anymore). I base my project estimates on how fast I can work given all that I need is available.
I've recently had a project where the client's Internet connection didn't just slow me down a little- it TRIPLED my work time. Clicking a link and waiting 5-10 seconds for a page refresh is not acceptable when you have 8000 pages to sort through, develop a business-functional categorization scheme for, and assign out to hundreds of users, not to mention THEIR issues with using the site.
So I'm a little sensitive to this issue, and I certainly hope we can find some sort of workaround :)


Last edit: by toccms
Back to the top
 
Posted
Rating:
#34587
Avatar

Community saint

 

Allen said

toccms said

Thank you Fletch. I'm hoping that at the worst, I'll be able to self-download or self-print (to PDF) the tutorials as a single file. (Edit- found via the SiteMap that my site has the Dev Guide already, so that's not needed anymore). I base my project estimates on how fast I can work given all that I need is available.
I've recently had a project where the client's Internet connection didn't just slow me down a little- it TRIPLED my work time. Clicking a link and waiting 5-10 seconds for a page refresh is not acceptable when you have 8000 pages to sort through, develop a business-functional categorization scheme for, and assign out to hundreds of users, not to mention THEIR issues with using the site.
So I'm a little sensitive to this issue, and I certainly hope we can find some sort of workaround :)
  Hi toccms,

You're not the first person to ask for this and you have a valid point. We have plans in the works to make those docs readily available but there are some kinks we want to work out before releasing them widely.

I'll try and see if I can zip them up and send them to you, though. We might only be able to give you the comcode files right now, in which case you would need to have a working ocPortal installation to see them properly (or you could just read the text files which would have a bit of code in them). This might happen in the next day or so.
 
Hi Allen, thanks so much for the offer! I do have a working OCPortal install, which is where I found the dev guides- tricky tricky, hiding them in the Sitemap :) That being said, I actually went onto your tutorial site and printed all of them to PDF last night. I have free PDF print software that can save jobs and merge them into 1 file, so as of now, I've got all of the current tutorials on PDF and all of the dev docs (as of the latest OCPortal release) available from the Sitemap of my installation.
Thanks much for your response!
David 
Back to the top
 
1 guests and 0 members have just viewed this: None
Control functions:

Quick reply   Contract

Your name:
Your message: