diff --git a/README.md b/README.md index 33eca16..f639198 100644 --- a/README.md +++ b/README.md @@ -1,52 +1,35 @@ +## Pilot Light Build -
A lightweight game engine with minimal dependencies.
+### Requirements +* minimize duplicated information +* fine-grained control over compilation settings +* support unity builds +* support hot reloading +* generate scripts that can be used separately +* easily extended +* easy to add new platforms and compilers +* extremely light weight +* easy to customize and extended +* no preference on editor/IDE +* doesn't pretend different platforms don't exist +* entire build system can be understood in an hour - +Another way of putting it, is we want to focus on what matters to build binaries. Ultimately this is just compiler & linker settings. We don't want to think about the differences in bash/batch syntax. - +### Benefits Over Raw Scripts +Prior to this system, when we were writing scripts directly, we did what every developer does and began overengineering the build scripts to improve things like information duplication, configuration options, etc. However, this led to more compilicated scripts that were harder to debug and heavily deviated between platforms since batch/command are very different in features and syntax. It became hard for newcomers to work on and encouraged differences to creep in between the way individual build scripts worked. -- Information • - Developer Notes • - License • - Gallery • - Inspiration -
+Using pl-build allows the clever/overengineered solutions to be accomplished at a higher level by the user in python. In the end, build scripts are output that are very straight forward and much easier to debug. It also makes it easier to implement new backends to target new compilers, platforms, scripting languages, etc. - +### Alternatives -## Information -Under construction. +Keep in mind, **we don't want a build system**. We don't want to hide away details or abstract away control. We ultimately just need a tool to assist in generating the scripts for each platform. -## Developer Notes -Information for developers can be found in the [wiki](https://github.com/PilotLightTech/pilotlight/wiki). This includes: -* [building](https://github.com/PilotLightTech/pilotlight/wiki/Building) -* [contributing](https://github.com/PilotLightTech/pilotlight/wiki/Contributing) -* [style guide](https://github.com/PilotLightTech/pilotlight/wiki/Style-Guide) +What about other CMake (and others)? They are bloated over complicated messes. They are also overkill for what we need (see Requirements section above). -## License -Pilot Light is licensed under the [MIT License](https://github.com/PilotLightTech/pilotlight/blob/master/LICENSE). -## Gallery - - - -## Inspiration -This project is inspired by: -* [Omar Cornut](http://www.miracleworld.net/) & [Dear ImGui](https://github.com/ocornut/imgui). -* Casey Muratori & [Handmade Hero](https://handmadehero.org/) -* Turánszki János & [Wicked Engine](https://wickedengine.net/) -* [Sean Barrett](https://nothings.org/) & his [stb](https://github.com/nothings/stb) libraries -* _The Machinery_ before they were abducted +## Documentation +Documentation can be found [here](https://github.com/PilotLightTech/pilotlight/wiki/Build-System).