Giter Club home page Giter Club logo

Comments (2)

kitty624 avatar kitty624 commented on September 2, 2024

In the SCI I'm using that. Probably too long. But a good chunk of it might be worth it? A lot of the content could get links instead (to starter documentation, forum pages, etc.)

Supervison by a person more firm in english might be a good idea for that as well :-)

https://www.mediafire.com/file/szcab8zxx2mf7ed/-_A_ReadMe_for_JA2v1.13_SCI.txt/file

Or do you think more on a readme specific to source only?

from source.

Nindaleth avatar Nindaleth commented on September 2, 2024

Disclaimer: played vanilla JA2 back then, no hands-on experience with JA2 1.13, but I take a quick look at what¨s avaialable regarding JA2 once every 5 years or so.

I hope I'm not about to tell you what you already know and want to do anyway; my apologies if I am.

People on Github usually don't visit the organization's page (where there currently already is a little bit of info on 1.13), they tend to bookmark the individual repos. This source repo seems like the main one to me since it contains the most important parts and it has the highest development activity, also the releases will be done in this one I presume?

It's not unreasonable to expect the majority people will visit the repo (or any GitHub Pages you create on top of it), while only some visit forums and Discord. This might be different for 1.13 as everyone started at forums. The README.md would be excellent to answer some initial questions about 1.13 (or at least put a link into documentation repo somewhere near the beginning that has all the details). Imagine if people visited only one page to learn about the project, the repo's README.md is excellent for that.

For me (see the disclaimer), I'd be looking to README.md for information like:

  • what's 1.13 about, what does it add over vanilla? does it just fix the vanilla bugs and make an extra step in the original vision? or is it a package of improvements the original game never even thought about, adding cities, items, NPCs? list all the spotlight features 1.13 has (or at least put a link into documentation repo that has all the details and screenshots).
  • how does 1.13 compare to other JA2 projects, e.g. JA2-Straciatella? could 1.13 run on top of it since it seems Straciatella is an engine rewrite while 1.13 is designed as a mod?
  • what are the supported platforms? is this only Windows + Visual Studio or can you use different compiler and/or different OS?
  • is there any roadmap, what more do you want to achieve? both a specific "1.13 v1.0 must have these" list or just a vision of what you'd like are fine
  • how to compile, how to install (shouldn't be very long, if yes - just basic info + link to documentation repo)
  • what's the source code license? contributors might want to know that, it's very common on GitHub -- though this is often handled by a separate LICENSE file, not in README.md

GitHub also provides a wiki feature; potentially anywhere I say "documentation repo" it could also mean "wiki".

from source.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.