News article pages 404

[eluser]stuartr[/eluser]
[quote author="Aken" date="1363413421"]Guiding you in the right direction towards solving the problem on your own will teach you much more than handing you the answer. Which, I pretty much did anyway by stating that the 404 error was being generated by the function. Learning to debug and problem solve is an essential skill for a programmer.[/quote]

Most of the time I would agree with you, however with regards to errors in the tutorial, its more useful for these to be pointed out explicitly. As the stage of approaching a tutorial, particularly if trying to adopt a new mindset (e.g. moving to a framework approach), its not clear where my normal practices should apply, and where the framework has over-ridden these as part of the change in approach. This is why many of us, when adopting something like a framework will often miss things in a tutorial, that we would have picked up in the way we currently work.

As mentioned a tutorial is a key marketing tool for a framework such as CI, and there should be more focus on making it easy to follow and getting it right, as its usually after this that I will make a decision to adopt a particular framework and will be willing to spend time figuring it out in more detail.

That said, I believe that tutorials are the exception to the normal rule, and outside of the tutorial IMO you are completely right - guidance is what we need, to help develop our own problem solving skills and deeper understanding, rather than spoon-fed answers

[quote author="Aken" date="1363413421"]The tutorial can be updated by anyone with a Github account who knows how to make a pull request. If you'd like to help make CI better, you're welcomed to contribute.[/quote]

Probably not wise for CI noobs like myself to be updating a tutorial that we are having difficulties in following - I have seen too many instances of documentation being made worse by well-intentioned people who didn't really understand what they were trying to update.

The problem with tutorials is that the people with the understanding to make updates often don't see the errors due to their implicit understanding of "what is really meant" by an instruction, and the people who need the tutorial most will be caught out by the ambiguity.

Oh well, onwards and upwards, as I continue my adventures with CI :-)