Skip to content

Koyot-Digital/New-Wiki

Repository files navigation

ONPS Wiki

HTML5 CSS3 JavaScript License: KDAAL GitHub issues GitHub stars


🛠️ Development

This project is built with HTML, CSS, and JavaScript, and uses Prettier for consistent code formatting.

To exclude a node from Prettier formatting, wrap it like this:

<!-- prettier-ignore-start -->
[NODE HERE]
<!-- prettier-ignore-end -->

Resources


✏️ Contributing

For full contributing guidelines, see /CONTRIBUTING.md.

New to GitHub? Git can feel overwhelming at first, but it clicks quickly. This XKCD comic is a fun starting point:

XKCD 1597

For a solid introduction to core concepts like push, fetch, and pull, check out this beginner-friendly article.


📖 Writing Guidelines

Good writing helps people learn faster and find information when they need it. Here are the standards we follow.

🎯 Voice and Style

Write Directly to the Reader: Avoid unnecessary pronouns in instructions. Instead of "operators should check the pressure" or "you should check the pressure," write "check the pressure." It's more assertive, cleaner, and easier to follow. When a pronoun is needed, use gender-neutral options like "they," "them," or "operator."

Keep It Conversational: Professional doesn't mean stiff. Write like you're explaining something to a knowledgeable colleague standing next to you — clear, direct, and human.

For example:

DON'T:

The missile knows where it is at all times. It knows this because it knows where it isn't. By subtracting where it is from where it isn't, or where it isn't from where it is (whichever is greater), it obtains a difference, or deviation...

DO:

The missile knows where it is at all times. It knows this because it knows where it isn't.

🏷️ Formatting Standards

Headers and Titles: Use Title Case for all headings (e.g. "Pre-Start Guide" or "Emergency Situations") to keep navigation consistent and easy to scan.

Break Things Up: Long paragraphs are hard to follow, especially mid-procedure. Use short paragraphs and break complex ideas into digestible chunks.

Technical Terms: Always provide context when using terminology. A brief explanation can save a reader a lot of confusion. Don't just write "ECCS," link to a page or include a short description.

Acronyms: Use the <abbr> tag so readers can hover for a definition:

<abbr title="Emergency Core Cooling System">ECCS</abbr>

Not everyone will know what a CRAS or ECCS is, the tag makes the wiki more accessible to everyone.


🆘 Getting Help

Everyone gets stuck sometimes. Here's where to go.

Technical Issues: Open an Issue in the repository, or reach out to @gargleblaster_rmbk or @felix2557 on the Discord Server. Be as specific as possible about what you're trying to do and what's going wrong — it helps a lot.

Content Questions: Not sure if your changes fit the wiki's goals? Open an Issue and ask before investing a lot of time. It's always better to check first.

Common Gotchas

HTML Syntax: If you're new to HTML, start by editing text content rather than structural tags. For reference, check how similar pages are formatted, visit @gargleblaster-rbmk's HTML guide, or browse the Mozilla MDN Docs.

Image Formats: Only .AVIF & .SVG files are supported. This keeps file sizes small and pages loading fast. Large images slow down the site and hurt SEO.


📄 License

This project is licensed under the Koyot Digital Antiderivative and Attribution License (KDAAL).

About

This is the offical wiki for Oakridge Nuclear Power Station.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors