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.


Reading/expertise level

Login / Search

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

Discuss


Become a fan of ocPortal on Facebook or add me as a friend. Add me on on Twitter.
Was I helpful?
  • If not, please let us know how we can do better (please try and propose any bigger ideas in such a way that they are fundable and scalable).
  • If so, please let others know about ocPortal whenever you see the opportunity.
  • If my reply is too Vulcan or expressed too much in business-strategy terms, and not particularly personal, I apologise. As a company & project maintainer, time is very limited to me, so usually when I write a reply I try and make it generic advice to all readers. I'm also naturally a joined-up thinker, so I always express my thoughts in combined business and technical terms. I recognise not everyone likes that, don't let my Vulcan-thinking stop you enjoying ocPortal on fun personal projects.
  • If my response can inspire a community tutorial, that's a great way of giving back to the project as a user.
Back to the top
 
Posted
Rating:
#87636
Avatar

Community saint

Direct and present tense. High school level to make it easy for people to whom English is not their primary language.

We should assume that the person has at best had experience setting up a Wordpress site. This needs to be a basic step-by-step.

Bob
Back to the top
 
Posted
Rating:
#87695
Avatar

Community saint

Any additional thoughts on this?

Bob
Back to the top
 
Posted
Rating:
#87705
Avatar

Community saint

Don't know I think the wordpress thing is a big assumption?
Back to the top
 
Posted
Rating:
#87721
Avatar

Community saint

Duck said

Don't know I think the wordpress thing is a big assumption?
I'm a bit hesitant on this too. I think that we might be better off just assuming that the reader can read at the high-school grade level and write clearly and concisely without any further expectation.

Bob
Back to the top
 
Posted
Item has a rating of 5 (Liked by BobS)  
Rating:
#87723
Avatar

Community saint

Duck said

Don't know I think the wordpress thing is a big assumption?

Agreed. I've never used Wordpress but I have used many of the other CMS's. I would approach this as the reader has no experience with any CMS.

Steve
Back to the top
 
Posted
Item has a rating of 5 (Liked by BobS)  
Rating:
#87725
Avatar

Well-settled

Duck said

Don't know I think the wordpress thing is a big assumption?

I agree here. I have done a lot of web sites using a lot of different tools and had never done anything with Wordpress until very recently. The people I know using Wordpress are just that – users. They have no clue how to set it up.

I feel it is a lot better to avoid comparisons to specific things people might have used instead focusing on defining a problem/situation and then offering a solution using ocP.

Related to this, there is a jargon issue that will need to get addressed somewhere in the book. What makes it interesting to me is that it is more of an issue for non-newbies. For eample, ocP has members but users is a more common term. For a newbie, you only need to talk about members, CEDI, catalogs, … explaining what they do/can be used for. But, somewhere, you need to offer a "decoder" for those with more experience with other CMSs.
Back to the top
 
Posted
Rating:
#87728
Avatar

Community saint

felipe said

Duck said

Don't know I think the wordpress thing is a big assumption?

I agree here. I have done a lot of web sites using a lot of different tools and had never done anything with Wordpress until very recently. The people I know using Wordpress are just that – users. They have no clue how to set it up.

I feel it is a lot better to avoid comparisons to specific things people might have used instead focusing on defining a problem/situation and then offering a solution using ocP.

Related to this, there is a jargon issue that will need to get addressed somewhere in the book. What makes it interesting to me is that it is more of an issue for non-newbies. For eample, ocP has members but users is a more common term. For a newbie, you only need to talk about members, CEDI, catalogs, … explaining what they do/can be used for. But, somewhere, you need to offer a "decoder" for those with more experience with other CMSs.

Sounds like a glossary appendix would be a good idea.

Bob
Back to the top
 
Posted
Rating:
#87731
Avatar

Community saint

BobS said

felipe said

Duck said

Don't know I think the wordpress thing is a big assumption?

I agree here. I have done a lot of web sites using a lot of different tools and had never done anything with Wordpress until very recently. The people I know using Wordpress are just that – users. They have no clue how to set it up.

I feel it is a lot better to avoid comparisons to specific things people might have used instead focusing on defining a problem/situation and then offering a solution using ocP.

Related to this, there is a jargon issue that will need to get addressed somewhere in the book. What makes it interesting to me is that it is more of an issue for non-newbies. For eample, ocP has members but users is a more common term. For a newbie, you only need to talk about members, CEDI, catalogs, … explaining what they do/can be used for. But, somewhere, you need to offer a "decoder" for those with more experience with other CMSs.

Sounds like a glossary appendix would be a good idea.

Bob

Chapter one, first or second page. Maybe a conversion table? This way the reader who has used another CMS can convert what he/she already knows term-wise to what ocPortal uses right from the very beginning.

Steve
Back to the top
 
Posted
Item has a rating of 5 (Liked by BobS)  
Rating:
#87732
Avatar

Community saint

sholzy said

Duck said

Don't know I think the wordpress thing is a big assumption?

Agreed. I've never used Wordpress but I have used many of the other CMS's. I would approach this as the reader has no experience with any CMS.
Totally agree. No CMS experience should be necessary.

felipe said

I feel it is a lot better to avoid comparisons to specific things people might have used instead focusing on defining a problem/situation and then offering a solution using ocP.
Agree.

felipe said

Related to this, there is a jargon issue that will need to get addressed somewhere in the book. What makes it interesting to me is that it is more of an issue for non-newbies. For eample, ocP has members but users is a more common term. For a newbie, you only need to talk about members, CEDI, catalogs, … explaining what they do/can be used for. But, somewhere, you need to offer a "decoder" for those with more experience with other CMSs.
This one is easy. We do what a lot of business documents do and that is to provide a terminology appendix (I forget what its called exactly) or dictionary.

There we throw in every acronym or term that is likely to be new, or confusing, to the average person. The only difference between our one and a typical business one is that the business one will only contain only terms that are found in the rest of the document, were as we can include terms which people may expect to see but we don't actually use.

For example:

* CEDI - Is there because its ocp terminology.
* Wiki - Is there because many people will expect discussion on Wiki. And we would explain it as either 'See CEDI' or 'Wiki is bla..bla……, the ocp wiki is CEDI'.
* User - See member.

Do you have a Samsung Galaxy S / Galaxy S II ? If so, why not check out my ScreenFree FM Radio .
Back to the top
 
Posted
Item has a rating of 5 (Liked by BobSLiked by FletchLiked by psydoc)  
Rating:
#87911
Avatar

Community saint

Keep it simple. Most new users have no idea how to setup a database. This is also depended what for account is used, shared or virtual server or dedicated. Most users will use a shared, and thats the level where we have to deal with I think.


http://digiflash.nl Photo community  (dutch)
Back to the top
 
Posted
Item has a rating of 5 (Liked by Fletch)  
Rating:
#87913
Avatar

Community saint

Harry_

I also think we need to write for the typical user with minimum knowledge of setting up a site. My thinking is that someone who is more proficient will understand that he is more competent and will look for the next stumbling block.

Bob
Back to the top
 
Posted
Item has a rating of 5 (Liked by Fletch)  
Rating:
#87914
Avatar

Community saint

Bob,

thats correct. The problem is most that people seeing all the possibiltys of OCP and jump off before to start. Or install it, and run into several questions and come demotivated to go on or ask for help.

Yes I know there are many video's and help for it here on the site, but many are not so good in English to understand how to use it. So this is a point of view how to set up the whole book structure.

Harry


http://digiflash.nl Photo community  (dutch)
Back to the top
 
Posted
Item has a rating of 5 (Liked by FletchLiked by BobSLiked by sholzy)  
Rating:
#87941
Avatar

Community saint

What about organizing topics as we plan so that they are rated on different Skill levels like Beginner, Intermediate, Advanced?

Then subject matter in the book can be highlighted in this fashion so that different levels of users can easily skip sections not pertinent to them.
Back to the top
 
Posted
Item has a rating of 5 (Liked by sholzy)  
Rating:
#87943
Avatar

Community saint

Colour coded too, just like they already appear in the ocPortal 'tutes'?

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
Item has a rating of 5 (Liked by sholzy)  
Rating:
#87944
Avatar

Community saint

Fletch said

Colour coded too, just like they already appear in the ocPortal 'tutes'?

That's what I was thinking.  :thumbs:
Back to the top
 
Posted
Item has a rating of 5 (Liked by BobS)  
Rating:
#87988
Avatar

Community saint

Fletch said

Colour coded too, just like they already appear in the ocPortal 'tutes'?
Or, you could just use color coding.  :ninja:

Harry-S said

Bob,

thats correct. The problem is most that people seeing all the possibiltys of OCP and jump off before to start. Or install it, and run into several questions and come demotivated to go on or ask for help.

Yes I know there are many video's and help for it here on the site, but many are not so good in English to understand how to use it. So this is a point of view how to set up the whole book structure.

Harry
I could not agree more, Harry. I was not new at coding when I started using OCP, and yet, I almost gave up because of the complexity. That very complexity is what makes OCP so flexible; however, it can be very intimidating at first.

Back to the top
 
Posted
Rating:
#87993
Avatar

Community saint

psydoc said

I could not agree more, Harry. I was not new at coding when I started using OCP, and yet, I almost gave up because of the complexity. That very complexity is what makes OCP so flexible; however, it can be very intimidating at first.

This will be one of the major challenges and something that I would like to see discussed further in the design topic. I think we have a few good and viable ideas but we want to pull the best solutions forward for inclusion in the book.

Don't assume your idea has no merit  pitch it here. It might be valuable now or as we move the process further down the road.

Bob



Last edit: by BobS
Back to the top
 
Posted
Item has a rating of 5 (Liked by BobS)  
Rating:
#88018
Avatar

Community saint

This is just an idea, and may have been what Fletch meant; but, why not have more than one level of expertise represented?

Have a very basic, step-by-step guide for beginners. The chapter could start with an explanation, "if this chapter is too basic, skip to the next chapter". That chapter could start at an intermediate level. It could also include a similar bit of advise.
Back to the top
 
Posted
Rating:
#88023
Avatar

Community saint

psydoc said

This is just an idea, and may have been what Fletch meant; but, why not have more than one level of expertise represented?

Have a very basic, step-by-step guide for beginners. The chapter could start with an explanation, "if this chapter is too basic, skip to the next chapter". That chapter could start at an intermediate level. It could also include a similar bit of advise.
We definitely need to address the intermediate user as well as the novice. I'm not sure whether the best approach is a progression within chapters, sequential chapters or later chapters aimed specifically at intermediate users. My gut feeling at this point is that the last choice, later chapters geared towards more advance users might make the most sense and be the least problematic in terms of presentation. After all, even the novice who learns the basics from the early chapters might want to delve more deeply into the same subject matter at a later point.

Bob
Back to the top
 
There are too many online users to list.
Control functions:

Quick reply   Expand