Jump to content
everlearners

When will documentation wiki be updated?

Recommended Posts

everlearners    1
everlearners

I just spent an hour or so looking for the "Intro Unit" section in my Pagelines install, as described in the documentation wiki at http://www.pagelines.com/wiki/How_to_Use_Intro_Unit. I finally figured out that within Pagelines it is called the "Hero Unit" instead. The documentation wiki does not contain that term. Pagelines 2.2 was released two months ago today. The documentation wiki is inaccurate and incomplete. You are charging premium fees for a premium product. I expect that to include premium documentation as well. My 30-day trial is coming to an end soon. Please give me a timeline on when the documentation will be updated so I can decide whether I should request a refund or not.

Share this post


Link to post
Share on other sites
Danny    1,327
Danny

Hi, We apologise for our outdated documentation. Our Wiki is constantly being updated and I have informed our docs team regarding the error with the Hero section docs page.


Please search our forums, before posting!

Share this post


Link to post
Share on other sites
everlearners    1
everlearners

Danny, you make your documentation process sound very haphazard. I find your answer to be unsatisfactory, because you cannot tell me when the documentation will be complete. That makes me feel like I have invested in the wrong framework.

  • Like 1

Share this post


Link to post
Share on other sites
Rob    547
Rob

Hi Everlearners, I am quite sorry you feel that way and agree that our documentation is lacking. I won't attempt to make excuses, but explain that our documentation is a fluid document and not a static one. Products are released often with insufficient documentation and there's simply no excuse for it. I cannot give you a defined date and neither could Danny, as this request has to go to higher authority than either of us. It's not that we're avoiding it, but as a rapidly growing company, some things go amiss. We humbly apologize. Nonetheless, we do try to answer direct questions about any of our products here, in Live Chat (for Plus members) and via other means whenever someone asks. I must say, it's rare that people even read the documentation or take the time to peruse it and perhaps that influenced the lack of effort. We'll certainly address it as fast as possible. Currently I'm dashing off a note to our developers on this and deeply appreciate your patience.


Former PageLines Moderator, Food Expert and Raconteur

Share this post


Link to post
Share on other sites
everlearners    1
everlearners

rangelone, I appreciate your candid response. Perhaps I am different than other customers, but I do rely on documentation when I am developing with a new product. With good documentation, I am able to find an answer quickly rather than wait for a forum reply (though to your credit, you are very responsive in the forums). The shortcomings in your documentation go far beyond a simple error in the naming of one of the sections (still not corrected in the time since you reported it). There are many placeholder images, links that go nowhere, and completely empty pages. I understand that documentation is often a low priority, and is treated as an ongoing process, but when there are other frameworks that are completely free that also have good, usable documentation, it makes it hard to justify the premium price you are charging, even with a product that is as good as yours. I feel like I've given your product a fair shot. It may be a great product for many other users, but the poor documentation is a deal-breaker for me. I'll keep an eye on the progress of your product and your documentation, and would be willing to come back and give it another try at some point in the future if I see things have improved. Many thanks

Share this post


Link to post
Share on other sites
catrina    103
catrina

No problem. We'll be improving the documentation, but there has been no set time that I've heard.


Please read the docs before posting. Please do not private message me unless I ask you to.

Designer | Catrina Dulay

Founder | Catrina and Mouse

Share this post


Link to post
Share on other sites
kristjan72    1
kristjan72

I find it interesting that searching the Pagelines Wiki for "Hero Unit" still returns no results, a more than six weeks after everlearners pointed the omission out.

Seems to me that if the documentation was up to par, it would save you guys a lot of time in the forums. On all your profiles it says something to the effect of: "Read the documentation before posting". I agree with this. It is simple forum etiquette.

However after searching the documentation a few times and getting lost and getting bad or incomplete information (and sometimes plain wrong info) what happens is that for my next question I will not even turn to the documentation, but come straight here, to the forums, thus increasing your workload...

In the long run, a little time invested in the how-to documentation will result in time saved...

and this:

I must say, it's rare that people even read the documentation or take the time to peruse it and perhaps that influenced the lack of effort.

is just a really poor excuse, not to mention rude. The lack of good documentation educates us, the customer, not to rely on it. With good documentation it is easy to educate forum users with a simple RTFM response...

Sorry if this turned into a bit of a rant, but it is very frustrating to lots of users. I guess the doc team is not the same as the forum team, so their not directly feeling the effects of the bad wiki and docs, you guys are!

Share this post


Link to post
Share on other sites
Simon    247
Simon

kristjan72 The docs are being updated and they are a huge improvement over the wiki. Shouldn't be too long now.

  • Like 1

Share this post


Link to post
Share on other sites
kristjan72    1
kristjan72

Excellent news! Look forward to that! I'm guessing asking for an ETA is pushing it ;)

Share this post


Link to post
Share on other sites
Simon    247
Simon

Getting a reply on a sunday was pushing it lol. It should be soon, thats all ;)

  • Like 1

Share this post


Link to post
Share on other sites
Rob    547
Rob

The topic was marked as resolved.


Former PageLines Moderator, Food Expert and Raconteur

Share this post


Link to post
Share on other sites
randybrown    1
randybrown

I hate for my first post to this forum to harp on the negative (not my nature), but this problem of insufficient and outdated documentation extends beyond the docs.

I just purchased PageLines Plus over the weekend and my first attempt to receive some tutorials on how to use it came in the form of your tutorial videos that are posted on YouTube. I usually learn the best when I can watch someone doing what I need to do, rather than read some lengthy narrative about it from an instruction book.

But it appears that your tutorial videos were made using some earlier version of PageLines, because there's nothing in the videos that even remotely resembles the menu structure of the current version of PageLines. In other words, the tutorial videos are utterly useless. They only serve to confuse and frustrate. For example, in the video entitled PLET-1.2: How to Get Started with PageLines, not 30 seconds into the video it shows the basic menu structure of the dashboard in PageLines. On the video, the PageLines dashboard menu contains the options "Settings," "Meta," "Templates," "Store," and "Account." Yet in my installation of PageLines, only "Store" is a common menu item. In my installation, the menu selections are "Dashboard," "Site Options," "Page Options," "Drag & Drop," and "Store." So I'm not even a half-minute into the video and already the instructions don't match up with what I'm looking at. There is nothing that undermines confidence quicker than to have the instructions not match what is actually present in the software. TALK ABOUT CONFUSING!!! Then of course the selections from within each of the menu options are also completely different. I hate to say it, but your tutorial videos are about as useful in training me on PageLines as they would be if they explained how to take apart an automobile engine. It's almost as if they were designed for something altogether different than training people to use PageLines. And yet this particular video was updated just 9 months ago. It's not like they're five years old.

Am I frustrated? Yes. Am I confused and feeling totally lost? Absolutely. Am I perplexed over how a company that touts itself as a premiere framework builder could leave its customers completely in the dark about how to use their product? You bet your ass I am.

But more importantly, I'm in a real quandary. How am I supposed to learn how to use this framework if the only documentation you offer is wrong and the tutorial videos you have online is wrong? Am I supposed to just meditate on it or pray for an epiphany? Shall I wait for divine guidance? Or am I just out the $97 with little more than your best wishes that I find my way on my own?

I don't even know where to start.

  • Like 1

Share this post


Link to post
Share on other sites
WebWerx    0
WebWerx

Hey Randy: I feel your pain. This has been a PageLines issue since I began using the platform. That being said, I find that "doing" = "learning". If you understand Wordpress, things are even easier. Once you get the hang of it, things fall into place quite well.

I still think Mr. Powers and company should step back a bit an focus on creating proper online educational materials versus constantly updating the platform. I bet these forums would be less busy if the basics had been covered up front.

I will dismount from my SoapBox.

Share this post


Link to post
Share on other sites
Rob    547
Rob

Randy, like WebWerx, who isn't a moderator, I too feel your pain.

We are working feverishly to improve our documentation. This product has grown so much and so rapidly that things change before the documentation, and particularly the videos. I do apologize, on behalf of the PageLines team for this. When that video was made, the Dashboard and PageLines options were as you saw them in the video. Over the fullness of time, which in online terms means a minute or two ago, things changed and we found ourselves with different options in the Dashboard.

I know it's confusing and frustrating for our clients, but equally, if not more so to our moderators. Time's simply not on our side.

Anyway, I know that the new docs are soon to be released and assure you that we will continue working to improve them.


Former PageLines Moderator, Food Expert and Raconteur

Share this post


Link to post
Share on other sites
WebWerx    0
WebWerx

Hey Rob: How about you cook up some new docs? :thumbsu:

Share this post


Link to post
Share on other sites
randybrown    1
randybrown

Here's a suggestion for you guys. All your YouTube videos were made with the old interface. Rather than having to update ALL the videos (I know what a hassle that can be, I do video production), how 'bout you guys produce ONE video that provides some sort of translation so we newbies to PageLines can at least know where things moved from/to. We have absolutely no point of reference whatsoever. And even the online docs are wrong. So there's NOTHING to help us get started that isn't wrong/misleading/confusing.

Just produce ONE video and ONE document to sort of provide a translation from the old interface to the new one, explaining where things WERE and where they moved to.

Heck, I don't even know in which version it was that things moved. There's NOTHING to give me a clue.

Share this post


Link to post
Share on other sites
randybrown    1
randybrown

WebWerks said:

I still think Mr. Powers and company should step back a bit an focus on creating proper online educational materials versus constantly updating the platform. I bet these forums would be less busy if the basics had been covered up front.

I've spent my whole career (since I was 16, way back in 1969) in broadcast media. And if there's one thing I've learned through the years, it's that if you get out ahead of your audience, you will leave them behind.

In the age of technology, it remains baffling to me that tech companies don't grasp the importance of communication and education in a way that conveys the info to a LAY PERSON, not merely another internet/technology geek. I've read so many instructional books that seem written by people who assume WAYYYYYYY too much prior knowledge on the part of the reader. THIS JUST IN: If I knew what you know, I wouldn't have to read the freakin' instructions!!!

I'm not saying you have to dumb it down (well, maybe I am). But what I am saying is, if you want to EXPAND your audience, you've got to communicate not just to the already knowledgeable, but to those who don't yet know, but want to learn. Remember, there was a time when you didn't know this stuff, either. Someone had to help you along. If they hadn't, you'd be working the checkout register at WalMart. The problem I've observed with most tech people is that while they're quite good interacting with computers, their people skills are next to non-existent. It's no wonder they're not very good at communicating or educating.

But I'm persistent and determined. I'll figure this out eventually. I know just enough about WordPress already to be barely competent at an entry level -- as long as nothing ever goes wrong. If I have to write code or do something that requires that code be inserted, I will ask enough dumb questions until I get the answer I need. But my frustration-o-meter might get pegged in the process. And at my age, my blood pressure can only take so much of that.

Share this post


Link to post
Share on other sites
randybrown    1
randybrown

Honestly, my eyes just glaze over at the sight of this documentation. Without an update to the videos to explain where commands moved from and to, I'm sort of lost. I guess I'm just one of those people who learns better by watching someone else do it than I do from reading about how to do it. Especially when reading about it includes a bunch of technical gobbledegook that I don't understand in the first place.

Please, please, please...get someone on updating the videos. You don't need to produce a whole new set of videos. But you do need ONE video that explains where everything used to be and where everything is now so we can translate the old videos to the new interface. It can't be that hard. And you guys have had months to get it ready. It's inexcusable to leave your users in the dark like this.

Share this post


Link to post
Share on other sites
Danny    1,327
Danny

The docs I'm working on will not contain video material, the reason for this is video tutorials become obsolete very quickly. As you have probably noticed with the videos we have at the moment.

That is why I have chosen not to include any, I am not saying that the docs will never include any video material but at this moment in time it has a low priority.


Please search our forums, before posting!

Share this post


Link to post
Share on other sites
Rob    547
Rob

Folks, we usually don't look at resolved topics. If you have a question open a new one so that a moderator will reply.


Former PageLines Moderator, Food Expert and Raconteur

Share this post


Link to post
Share on other sites
Danny    1,327
Danny

The Support Center including new documentation is now live!

Please bear with us while we are still adding images and making sure everything is in it’s place.

http://support.pagelines.me/




Please search our forums, before posting!

Share this post


Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now


  • Similar Content

    • janpeeters
      By janpeeters+
      Over the last month I had extensive communications with the developer of the (premium) Anything Boxes section (in Pagelines store) (Adam Munns) and the developer of the WP Polylang Multilingual plugin (Frederic Demarle).
       
      This was because the following problem occurred:
      Anything Boxes showed all posts of two languages (Dutch and English) on the respective static frontpages for each language. It should of course have filtered posts for Dutch language on the Dutch frontpage and English on the English frontpage.
       
      The solution to this problem was simple in the end. When duplicating a page for use in another language the settings for Anything Boxes were not copied to the new page and I should have set these settings manually again on the new page. I wasn't aware of this, but it makes sense. Because of this the pages didn't know how to differentiate between posts from different languages.
       
      The dev of Polylang told me that Polylang is currently smart enough to synchronize metas like Featured images and page templates but it does not work out of the box with metas created by plugins and themes but (according to Frederic) it is rather easy to add them in the list using the filter 'pll_copy_post_metas'.
      He mentions that he is not sure that these 'PageLines Meta Settings' are stored in post meta but that would make sense according to him. He asks if the Pagelines dev team will be interested to support this feature in the future.
       
      I'm also wondering if you will consider adding Polylang translation support for manually editable strings like the 'Read more…' strings in Pagelines Settings.
       
      Well that's of course up to you but I thought to let you know to be able to take this into consideration. I also post this for other users in case they experience the same kind of trouble and are looking for an answer.
       
      Best regards,
      Jan Peeters
    • bankrollbuilder
      By bankrollbuilder
      I used a custom hook to put a banner ad in my header. It works but its not in the right position. it is centered and above my logo and I would like to float it to the right of my logo in the header. heres the link: http://shaboopie.com/shaboopie-wp/free-logos-pg1/

      thanks.

      Dan B.
    • starlit
      By starlit
      Can one have two hero sections on one page?

      I want a landing page which leads/advertises two subpages.

      Or is there another option?

      Please help.

      THANK YOU
    • hutruk
      By hutruk
      Hi!

      I am using the shortcodes for tabs, as described in the documentation.

      When I insert the following code:


      [pl_tabs][pl_tabtitlesection type="tabs"] [pl_tabtitle number="1"]Title 1[/pl_tabtitle] [pl_tabtitle number="2"]Title 2[/pl_tabtitle] [/pl_tabtitlesection] [pl_tabcontentsection] [pl_tabcontent active="yes" number="1"] Lorem ipsum dolor sit amet, consectetur adipiscing elit [/pl_tabcontent] [pl_tabcontent number="2"] Lorem ipsum dolor sit amet, consectetur adipiscing elit [/pl_tabcontent] [/pl_tabcontentsection] [/pl_tabs]

      I get a strange output (in the attachment).

      Any ideas?

      Thanks in advance!

    • MooiWeb
      By MooiWeb
      Hello,

      I would like to align my qtranslate with my breadcrumb so that the flags are on the same hight.
      I'm aware of putting a code in the custom css and tryed severall codes from your site but for now, no succes

      The site i'm working on is http://nieuw.vazdias.nl

      Thx,
      Edwin



×