A possible valedictory

[connorhawke]

Good points. :)

[bfarber]

I realise you are not IBM and do not have the same resources.

[*]Using the dox online is a pita .. I should be able to run them locally. It is ok for you guys with adsl(ie fast) but searching/browsing through the system is sooooo tedious [*]You example of a good doc page did you load it? The code sample?????? It dunna look all dat good huh! [*]More than me has asked that a reasonable 'hello world' applcation be written that has all the bits there so that we can use that as a start off to what we need .. ie change the dir name to our app and we have our_app_hello_world [*]Making a system IN_DEV is still broken [*]Exporting an application from in_dev is (my opinion) absolute CRAP I should be able to say gimme my app and get it all packaged not have to remember to import/export the skin, import/export the language, reload hooks etc etc etc ... bad bad bad [*]NEXUS! <<<< If it aint in the old source I have the I am STUCK ... at the very least make the source available to people who do stuff with Nexus as I said there are a number of things that could be added but no access leaves us in the cold ... did I mention dox? [*]Searching/browsing the dox and the so called KB sux big time have a look at

Q2A

I have to run this on RBR as Content is totally useless when it comes to managing a KB. Add this functionality to Content and use it you will love it and so would we ... don't tell me it is already possible, if it were you would have done it already. [*]Feedback .. you guys don't give us feedback when we make suggestions. It is all well and good to use one of the standard excuses that have been used but if someone makes a suggestion and it is accepted say so, if it is rejected say so ... then we have the chance of possibly explaining in more detail what it is we want/need. [*]sigh I am getting worked up again just trying to go through my list... [*]How about Wordpress it auto downloads its own updates, can install stuff directly off their equiv of the marketplace [*]












We have one





















Just throwing a suggestion out there: wikify the dev articles? As in, allow seasoned developers (several of whom have commented above) to actively take part in editing the articles. The edits don't have to be applied immediately, but can be reviewed, e.g. by bfarber and whoever else is in charge overall with those. Sure, there's the commenting system, but I think that developers would be more encouraged to develop the articles if given a more active part in writing them.




separate database

The vast majority of your suggestions have absolutely nothing to do with documentation. :) I encourage you to post individual feedback topics for things not related to documentation in the appropriate areas. 1) You are free to print and/or download documentation articles using the buttons below them. By keeping them online in a database, we can update them (as we are doing now...) when changes occur. 2) I'm not sure what you are referring to. I don't think I linked to a documentation article and said "this is a good article". :unsure: Everyone has a different opinion on what "good" is. 3) , it is out of date, and will be updated. This is why it's currently in the "temporary storage" category, as I mentioned previously. 4) This has nothing to do with documentation...however I am not aware of anything "broken" about it, except a recently reported bug having to do with the XML skin (which is fixed for 3.3.2). I use IN_DEV locally, as do most third party developers I expect. 5) This has nothing to do with documentation. 6) We cannot make the source code available, I'm afraid. If there are things not documented well enough between the phpdocs and the individual developer documentation articles, please let us know exactly what you want to see documented with Nexus. 7) I'll take a look at the site, but this sounds like a preference more than anything. We have categories, and articles inside those categories. I'm honestly quite confused about what is "difficult" navigating the documentation. Perhaps some clarity on what exactly is confusing or difficult about clicking on a category, and then an article in that category, would help. :) (I'm not trying to be facetious either, just for the record - I truly don't understand what is confusing about the navigational structure). 8) This has nothing to do with documentation. 9) This has nothing to do with documentation. 10) This has nothing to do with documentation. We are toying around with an idea similar to this, but I don't have any information on it yet. IIRC, when we move over to the "New Documentation" setup, we want to get the community more involved with the official documentation areas. Right now there is where members of the community can contribute, and we agree this is a little fractured.

[Guest]

Can I download it all in one go ?? Don't think so.
As an example of not polishing look at the code sample, nicely aligned code mangled by the display system
May not be dox but it is the same issue

[Marcher Technologies]

Beyond and above(though this includes nexus, the grief, not me ripping the source open... I WISH lol).
I am dog tired of hunting your source for example usages.... allow me to tell a bit of a tale.
I have yet to see a documented full usage of the forums postClass API, Michael was kind enough to post how to make a new topic, but this is basic basic needs(adding a reply, updating the post cache when modifying via hook, etcetera)... I literally found it to be easier to properly use Michael's tutorials post API with less hassle, grief and headache, without documentation, and that makes me hurt a little.
Not to mention the whole graveyard of undocumented app methods that ARE first party Apps.
The comments are not that helpful, and this is coming from somebody has ripped open the whole of nearly every app... there's a LOT of useful items that lack usage examples of any kind.
And we all know using a method incorrectly is about 10x worse than not using it at all.... usage examples of the apps API is a gaping void, when it should be readily available.

[Marcher Technologies]

Not to state I'm not absolutely loving the thorough Kernel docs BTW, I really do appreciate that, just making my opinion that documentation is not finished at all with a simple update of what is there.... we have big holes ATM as developers.
Also... as a note... organization and usability wise the PHPDocs are... quite bad.... its not even segregated by app, is a total pain to navigate from one class to another in an application.

[Marcher Technologies]

also... would it kill anyone to run the PHPDoc on ALL of nexus? there is well over half the application missing here... and ATM that is the best method list we modders have to work with.

[Marcher Technologies]

also... would it kill anyone to run the PHPDoc on ALL of nexus? there is well over half the application missing here... and ATM that is the best method list we modders have to work with.

my bad... is search issue, irrelevant... search explicitly will not return the full results when i type in nexus even though it lists, first statement of organization of those stands, is mess.

[bfarber]

Beyond and above(though this includes nexus, the grief, not me ripping the source open... I WISH lol).

I am dog tired of hunting your source for example usages.... allow me to tell a bit of a tale.

I have yet to see a documented full usage of the forums postClass API, Michael was kind enough to post how to make a new topic, but this is basic basic needs(adding a reply, updating the post cache when modifying via hook, etcetera)... I literally found it to be easier to properly use Michael's tutorials post API with less hassle, grief and headache, without documentation, and that makes me hurt a little.

Not to mention the whole graveyard of undocumented app methods that ARE first party Apps.

The comments are not that helpful, and this is coming from somebody has ripped open the whole of nearly every app... there's a LOT of useful items that lack usage examples of any kind.

And we all know using a method incorrectly is about 10x worse than not using it at all.... usage examples of the apps API is a gaping void, when it should be readily available.

Not to state I'm not absolutely loving the thorough Kernel docs BTW, I really do appreciate that, just making my opinion that documentation is not finished at all with a simple update of what is there.... we have big holes ATM as developers.

Also... as a note... organization and usability wise the PHPDocs are... quite bad.... its not even segregated by app, is a total pain to navigate from one class to another in an application.

No one said we were done. :) In fact, I'm pretty sure we've been thoroughly clear that it is a work in progress that has started, and we are actively working on it. I pointed out in this thread, for instance, I added a good 5-10 new articles last week. If we were done, surely we wouldn't still be adding.

also... would it kill anyone to run the PHPDoc on ALL of nexus? there is well over half the application missing here... and ATM that is the best method list we modders have to work with.

As I take it you discovered by your last post, we've run the phpdocs on the whole of the suite - we didn't omit any files.

[Rimi]

I was looking at some of those kernel articles..just skimming. I'm wondering if for each article you can also provide a file of it being used somewhere in the IPS suite? That way we can see a live example of it and understand what's going on in the code through the documentation.

Additionally can I request an article on how to send PMs? Would like that one very much..

[bfarber]

(Replying to this topic isn't really the best way to note these things - your response will get lost eventually).

I'd recommend replying to the articles that need better examples stating so. I'll make a note about sending pms.

[Rimi]

Well ok. It was pretty on topic though. :P

[podz_en]

Fix those broken links in your documentations! Everything is broken!

[podz_en]

Is documenting everything a chore to you? Or you're better changing the methods every time you want to? Please make everything in-sync! Why is it you're releasing versions that have not had documentation?!

[bfarber]

Is there a specific piece of documentation you are looking for?

[Wolfie]

Just throwing a suggestion out there: wikify the dev articles? As in, allow seasoned developers (several of whom have commented above) to actively take part in editing the articles.

This gives me an idea. Will need to 'tweak it' some in my mind, but I have an idea that could be very useful indeed.

[Rimi]

Is documenting everything a chore to you? Or you're better changing the methods every time you want to? Please make everything in-sync! Why is it you're releasing versions that have not had documentation?!

The developer documentation is up to date..

[Mat Barrie]

The developer documentation is up to date..

No it isn't. For example, the "Creating a Payment Gateway" document refers to $this->transaction as a number, when it's actually an array. I really wish IPS would stop changing the blasted payment gateway prototype without documenting it. I've lost so many freaking sales due to it.

[podz_en]

The developer documentation is up to date..

You yourself browse the documentation, in a minute or two, you'll plenty of broken links and outdated manuals. You'll end using Google as your documentation provider.

[Rimi]

You yourself browse the documentation, in a minute or two, you'll plenty of broken links and outdated manuals. You'll end using Google as your documentation provider.

What're you looking for documentation on exactly? I've never run into such problems and instead being a problem yourself I suggest you actually point out the broken links to IPS so they can fix them.

[Wolfie]

I've never run into such problems and instead being a problem yourself I suggest you actually point out the broken links to IPS so they can fix them.

Don't agree with the wording, but the point itself is right on.

[podz_en]

The staff here couldn't believe they have the most lacking and incomplete documentation. Of course, they know it all!

[Wolfie]

The staff here couldn't believe they have the most lacking and incomplete documentation. Of course, they know it all!

Now where's that neg rep option when it would be really useful..

[Rimi]

The staff here couldn't believe they have the most lacking and incomplete documentation. Of course, they know it all!

What do you need documentation on? If you refuse to answer that question then its quite obvious that you're obviously a troll. Why are you so incapable of answering a simple question?

[bfarber]

This topic seems to be going in circles at this point.

If there is a documentation article that has broken links, please use the comment feature on it to point this out, or post a bug report in our "Documentation" category in the tracker.

If there is something specific you would like to see documented, please post in our Documentation feedback forum explaining exactly what you are looking for.

Saying "the documentation is lacking" without providing examples is unlikely to net you the results you are after, I'm afraid. As an example, in this post the client explained what they are looking for, and I'm going to look into this soon. Examples help immensely.

[Wolfie]

You yourself browse the documentation, in a minute or two, you'll plenty of broken links and outdated manuals. You'll end using Google as your documentation provider.

Overlooking your poor grammar (which can cause misunderstandings), what is said here is quite accurate:

I suggest you actually point out the broken links to IPS so they can fix them.

If there is a documentation article that has broken links, please use the comment feature on it to point this out, or post a bug report in our "Documentation" category in the tracker.

If there is something specific you would like to see documented, please post in our Documentation feedback forum explaining exactly what you are looking for.

podz, look at it from this point of view. You go to your doctor and say, "I'm in pain, heal me" but you don't tell your doctor where you hurt, in what way you hurt, anything you may have done to cause the pain, etc. How is the doctor supposed to know what to do to bring you relief? Simply saying, "There are broken links in the documentation" doesn't help because there are over a hundred pages that have to be browsed and on pages with links, there could be several links. Links that don't work for you might work for IPS staff because the content may just be hidden. Clicking the link, page loads up with an error, so "okay this link works" and move on to the next link.

So do what Brandon said, although I'd recommend posting it in the tracker over leaving a comment because then there's a central place to see all the reported problems. (If staff prefer it be comments on the page with broken links, then you should honor their preference.)

I've also commented on the documentation and it seriously helps to give details, because no one can read your mind to know what you're thinking.