Botworld Wiki Project

• Our objective is to provide the best resource possible for Botworld Adventure, at: https://www.botworld.wiki/
• The project is coordinated from the official discord server: https://discord.com/invite/FsJzvtFrgq

Project Organization

Overview

Content Types

Most of the content present on the site can be broken down into the following categories:

• Content sections (manually written content with potentially links & medias)
• Entity pages (bots, abilities, boosters, materials are all imported and a page is automatically generated)
• Entities lists (automatically lists the desired infos for the selected entities)

Some special and more advanced cases, best left to the most accustomed maintainers:

• Navigation blocks
• Dynamic features: Search, Upgrade Calculator...
• Custom Embeds (for discord integration)

Platforms and Resources

• Coordination: https://discord.com/invite/FsJzvtFrgq
• Code & Hosting: https://github.com/beatburger/beatburger.github.io/
• Collaborative documents incl. WikiSheets: https://drive.google.com/drive/folders/13ZKZipuTUg8KfSVQwKNKAoiKYJcuQ4fT?usp=sharing

HowTos

Content

Use Editor Mode (Editors)

This mode aims to provide a simple and straightforward way for everyone to edit specific sections of the content. In order to lower the skill requirements to contribute this way, the edition capabilities are restricted to simple and localized edits.

Requirements: Markdown markup language

• Activate
• Edit Content
  • Pictures
  • Video clips
• Precautions

Manage Pages (Maintainers)

Requirements: Markdown markup language, github

• Edit .md files directly
• Understanding a page structure
• Expose sections to Editor Mode
• Create a new page
• Merge Edits

Entities

They're collections of game elements that the wiki needs to be able to reference from many pages, request specific attributes, filter, etc. As such, they're not simply written down in a specific page, but instead stored as data from which everything can be generated automatically.

We went with a 2-steps process to work with them collaboratively:

• Infos are collectivelly gathered into WikiSheets (google sheets).
• Maintainers can export entries from the WikiSheets on request, convert them with the provided tool, and use the result to create/update the Entity on the wiki.

More about it on the dedicated page:

• WikiSheets
• Update an Entity
• Create an Entity
• Converters
  • Troubleshooting Converters
• Github Folders
  • Images

Embeds

Used for discord integration

Other

• Markdown Cheat Sheet
• url & filenames format conventions

Github for the wiki

• Get access
• Deployment

Developpers

• Update Cog

Roles

• Outside contributors: Get in touch with the project members on Discord accordingly
• Editors: Can update some content. No technical skills required
• Maintainers: Full content control. No programming skills required, must learn the project internals.
• Developpers: New features or design. Programming skills very much required!