Some FAQ entries to play around with layout

[dcsobral]

I'm not really suggesting importing this as is. Mostly, this is just to call attention to some sample content for the FAQ section I'm proposing.

[heathermiller]

I've skimmed through each of the FAQs you've added- they each look great!

I can pull them in and tweak the formatting a bit- no problem. For now, we could just keep them as a list in the Tutorials section.

Though we should also experiment with this idea of having an entire section devoted to these types of popular questions. I had suggested in the feedback/suggestions tab on docs.scala-lang.org that we could name the new section "Scala FAQs", "FAQs", "Popular Questions", or whatever else, and have a box on the homepage which statically displays, say 4 or 5 of these questions, randomly chosen, upon page load. Of course, open for discussion.

Regardless, it could always be a next step, and we could keep these in Tutorials for now.

[dcsobral]

I have two concerns. First, it isn't obvious that a FAQ is inside "Tutotrials". Second, the questions don't show up on the Tutorials page itself -- unless I should move them into a "FAQ" tutorial page?

[heathermiller]

Sure- of course it's not obvious that they're inside Tutorials, I only suggested that as a temporary solution. In my previous message, I mentioned that we should experiment with the idea of having them in their own section, name to be discussed, and then feature them on the home page as well. I was waiting for your thoughts before going ahead and reorganizing things that way.

The second point- questions don't show up on the tutorials page- the questions are the titles of each page, and they're listed directly underneath the "Scala for XYZ programmers" box. Perhaps I don't understand your question/concern?

(Btw, please force-refresh- I've made a few changes to your original pull)

[dcsobral]

Oh, yes, that's the way I think we should go (separate section). I see how you have changed the layout, and I think it will do for now. It was my original pull request that was too ugly to be made publicly available.