The Author Online Book Forums are Moving

The Author Online Book Forums will soon redirect to Manning's liveBook and liveVideo. All book forum content will migrate to liveBook's discussion forum and all video forum content will migrate to liveVideo. Log in to liveBook or liveVideo with your Manning credentials to join the discussion!

Thank you for your engagement in the AoF over the years! We look forward to offering you a more enhanced forum experience.

infos@wais-fr.com (29) [Avatar] Offline
#1
Sorry guys but another rude remark:

It seems you are familiar with the following pattern in this book : How to explain something in 4 steps.


Step1 :
Let us explain one method of doing the task:
bla bla bla

Step2 :
step1 is good for learning but bad in real scenario. Let us explain you another way of doing the same task:
bla bla bla

Step3:
step2 is good but only in limited scenarios. Let us explain a better way of doing the task:
bla bla bla

Step4
We, at Disqus, prefer the following way to make the task. Our method covers scenario described in step1, step2 and step3 and also covers all other scenarios.
Let us explain the right way of doing the task :
bla bla bla

I suggest that you refactor this pattern to the following pattern : How to explain something in 1 step with 3 possible variants

Step4
We, at Disqus, implements the UI using the following pattern : one <script> element and many <div> elements using the data-* mecanism as anchors to dynamically inject our UI .
This pattern solves such and such problem and has the following advantages : ...
Tip1 : you may use document.write as an alternative to this pattern; compare pros and cons (relative to your main pattern)
Tip2 : you may use only script element using the data-* and no div; compare pros and cons (relative to your main pattern)
tip3 : If the UI should be injected only once, you could use this simpler pattern (one script and one div with Id attribute) : compare pros and cons (relative to your main pattern)


Best regards
Henri d'Orgeval
benvinegar (68) [Avatar] Offline
#2
Re: 3.1.1 to 3.1.4
Hi Henri,

That's a valid criticism. But I think this doesn't consider that usually the first solution we present is usually the simplest. We could start off with "the one true way", and later look at other alternative solutions (that may or may not be advised), but we'd be going backwards in terms of difficulty. Also, we often introduce concepts that are easier to explain when we're scoped to a simpler solution – and I feel that's beneficial to the reader.