Repair readmes, Compatability w/ latest Zola version, Editors guide

README.markdown

@@ -3,12 +3,12 @@ These are the sources for Ludum Dare's informational website at `ludumdare.com`.
 
 * The `ludumdare.com` homepage
 * [The Rules](https://github.com/InteractiveSnacks/ludumdare.com/tree/master/content/resources/rules) for Ludum Dare events
-* Our [Best Practices](https://github.com/InteractiveSnacks/ludumdare.com/tree/master/content/resources/best-practices) guide
+* Our [Best Practices](https://github.com/InteractiveSnacks/ludumdare.com/tree/master/content/resources/guides/best-practices) guide
 * [Frequently Asked Questions](https://github.com/InteractiveSnacks/ludumdare.com/tree/master/content/resources/questions) and knowledge base [Topics](https://github.com/InteractiveSnacks/ludumdare.com/tree/master/content/resources/topics)
 
 The website is run by [Mike](https://github.com/mikekasprzak) and the team at [Interactive Snacks](https://github.com/InteractiveSnacks). Contributions are welcome and encouraged.
 
-`ludumdare.com` is powered by the [Zola](https://www.getzola.org) static website generator. See the editors guide (TODO) to get started.
+`ludumdare.com` is powered by the [Zola](https://www.getzola.org) static website generator. See the [editors guide](editors-guide.markdown) to get started.
 
 
 # IMPORTANT!
@@ -20,6 +20,6 @@ Looking to explore? Start in the [/content](content/) folder.
 
 If you have a question for the FAQ, [open an issue](https://github.com/LudumDare/ludumdare.com/issues) on GitHub.
 
-If you have an answer for the FAQ, fork the repository, [following the instructions](https://github.com/InteractiveSnacks/ludumdare.com/tree/master/content/resources/faq), and submit a pull request.
+If you have an answer for the FAQ, fork the repository, [following the instructions](content/resources/README.markdown#how-to-add-articles), and submit a pull request.
 
-We would also recommend checking out the editors guide (TODO).
+We would also recommend checking out the [editors guide](editors-guide.markdown).

config.toml

@@ -13,7 +13,7 @@ minify_html = false
 # Whether to build a search index to be used later on by a JavaScript library
 build_search_index = true
 # When set to "true", a feed is automatically generated.
-generate_feed = true
+generate_feeds = true
 
 ignored_content = ["*.markdown"]
 

content/README.markdown

@@ -9,7 +9,7 @@ As a contributor, you're probably most interested in the resources section. Thes
 
 * [Resources](resources) - the root
   * [Rules](resources/rules) - The Rules for Ludum Dare events
-  * [Best Practices](resources/best-practices) - Non-rule recommendations for participants
+  * [Best Practices](resources/guides/best-practices) - Non-rule recommendations for participants
   * [Questions](resources/questions) - Frequently asked questions
   * [Topics](resources/topics) - Knowledge base topics
 

content/community/README.markdown

@@ -1,6 +1,6 @@
 Stub for the Community section.
 
-We are not accepting submissions for these yet. We are going to start with the [`/games/`](/games/) section, and grow from there.
+We are not accepting submissions for these yet. We are going to start with the [`/games/`](games/) section, and grow from there.
 
 * the Social section contains social media platforms and chatrooms organized by language
 * the YouTube section contains metadata for YouTube creators creating Ludum Dare content, and their videos

content/resources/README.markdown

@@ -2,7 +2,7 @@
 Resources collects articles that are useful to participants of Ludum Dare. This section is broken down into the following subsections. 
 
 * [Rules](rules) - The Rules for Ludum Dare events
-* [Best Practices](best-practices) - Non-rule recommendations for participants
+* [Best Practices](guides/best-practices) - Non-rule recommendations for participants
 * Knowledge Base
   * [Questions](questions) - Frequently asked questions
   * [Topics](topics) - Encyclopedia of topics raised by questions, other topics, the Rules, and Best Practices

content/resources/guides/best-practices/README.markdown

@@ -1,4 +1,4 @@
 # Best Practices
 This is the Best Practices guide for Ludum Dare events.
 
-This document compliments [the rules](../rules/) with recommendations and general advice.
+This document compliments [the rules](../../rules/) with recommendations and general advice.

content/resources/rules/README.markdown

@@ -1,7 +1,7 @@
 # Rules
 These are the rules for Ludum Dare events.
 
-We have a second document ["Best Practices"](../best-practices/) that compliments the rules with our recommendations and general advice.
+We have a second document ["Best Practices"](../guides/best-practices/) that compliments the rules with our recommendations and general advice.
 
 ---
 

editors-guide.markdown

@@ -0,0 +1,4 @@
+
+# Setup
+
+To build and view the site locally, first [Install Zola](https://www.getzola.org/documentation/getting-started/installation/). Then run `zola serve` from the repository root. At time of writing (2025-09-07) this repository is compatible with latest Zola (v0.21.0).