New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Tutorial screenshot appears to be out of date. #870
Comments
Interesting observation. The screenshots show example pages filled with Lorem ipsum filler text (well, actually "lorem markdownum"; presumably someones attempt at being cute 👎 ). However, the actual text displayed at that point in the tutorial is not that text. but a single line header: "Welcome to MkDocs" (see mkdocs/commands/new.py#L9). The real question is: what should we change, the screenshots or the default text? The screenshots are definitely more attractive as they are today (they better demonstrate what pages could look like), but the the actual pages leave less for the user to replace/delete when they add some real content. |
I also notice that a second page is already present in the first screenshot, but adding a second page isn't covered until later in the tutorial (with no screenshot provided at that point). Seems to me like the tutorial needs a little work in general. |
+1 |
* Updated screenshots to reflect the actual pages in the tutorial (fixes mkdocs#870). * Added a few new screenshots to demonstrate more features (search). * Replaced the `initial-config.png` screenshot with a code block. * Corrected the inconsistant use of "you" and "we" throughout (use "you"). * Added links to various locations in the docs where appropriate. * General cleanup, formatting, etc.
When working through the tutorial, ("Getting Started" section) the screen shot displaying the default index page is incorrect (presumably out of date). (See on mkdocs, version 0.15.3, OS X and Windows.)
To reproduce:
(Also, the sentence "Once you hit reload in the browser you'll see your new site name take effect." contains a typo. It should be "Once you hit reload in the browser, you'll see your new site name take effect." Rewriting the sentence to something along the lines of "Reload the page in your browser to see the new site name." may be even better.)
The text was updated successfully, but these errors were encountered: