Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

warn the noobs away 😁 #1050

Closed
wants to merge 1 commit into from
Closed

warn the noobs away 😁 #1050

wants to merge 1 commit into from

Conversation

rahil627
Copy link

please... i ask of you: please... you must spare them! 😭

lol, but really tho, it’s a warning to myself, me, about three weeks ago, that might have waded me away from the deep end, and saved me a few weeks; and i think some kind of warning or more detailed summary could successfully sway off others who aren’t ready for what they’re getting into.

obviously no offense or anything (i’m the noob!), but, there’s gotta be a way to communicate where in the game io framework to complete game engine spectrum this belongs... and surely it could save you pro programmers from us game-designer idiots asking idiot questions. :)

@Yanrishatum
Copy link
Contributor

Yanrishatum commented Feb 17, 2022

I don't think copying informal text of /rtfm command I threw a few years ago into main readme is a good idea. I do agree that having a more clear explanation of what this engine actually is (i.e. barebones engine for experienced developers) on main page is a good idea. (For same reason FAQ is still unofficial - I don't want to bother with rewriting it from informal language)

@rahil627
Copy link
Author

yeah the informal tone is a bit rough, along with the unofficial FAQs, but when i personally stumbled upon that bit of text in the Discord, it hit me, hard. I felt that. And that just may have been what i needed, and what others need.

also, i didn’t feel like i was in a position to write what Heaps is or isn’t, so i had to copy it from one of your mouths. 😁

@rcstuber
Copy link
Contributor

rcstuber commented Feb 17, 2022

I think the fact that Heaps is promoted as "cross-platform" on its website is most misleading. People expect a Unity-style write once, press button and publish to any platform kind-of engine. Hard truth is - while being able to run on all these platforms - almost nothing apart from Desktop is anywhere near out-of-the-box. This (apart from the lack of documentation) to me seems worth a word of caution to new users.

@rahil627
Copy link
Author

from the repo:

Heaps is currently working on:
HTML5 (requires WebGL)
Mobile (iOS, tvOS and Android)
Desktop with OpenGL (Win/Linux/OSX) or DirectX (Windows only)
Consoles (Nintendo Switch, Sony PS4, XBox One - requires being a registered developer)
Flash Stage3D

from the site:

PUBLISH ANYWHERE
With Haxe, you can easily build cross-platform tools targeting all the mainstream platforms natively.
...
CROSS PLATFORM COMPILATION
One source code that compiles natively to the platform you want!

i just checked the web-site’s home-page, i think it was written to just kinda fit that generic product advertisement tone— “easy to get started”, it’s very fast! even a caveman can do it!—to it, lol. But yeah, i can see that being misleading... but maybe MonoGame advertises itself the same way... and that’s def not Unity one-click smooth.

@deepnight
Copy link
Contributor

I agree that communication around Heaps engine is rather lacking and not explicit enough.

I mean: we're not selling some product, it's just about "street credit" and opening the tools to advanced devs that could be interested in them.

Don't get me wrong, Heaps is amazing and I will use it for most of my future projects. But I agree it's not an easy to use toolkit as falsely represented on the official website.

So I think paying someone to rework the https://heaps.io website accordingly would be a better approach than tweaking the git README which is already an advanced thing for most people not used to open-source world.

@rahil627
Copy link
Author

rahil627 commented Mar 2, 2022

ahhhh hah, yeah that’s true, the site comes first since it’s more accessible. It’s a bit unfortunate as it looks like some soul put some love ‘n effort into making that site. :(

i don’t even think anyone has to be paid. I think all it requires is some good writing to convey the right ideas about what Heaps is and what Heaps isn’t, which can then be copied to both the home-page and github readme (the github readme in lower priority). All it needs is a good, simple, honest summary, that we can all agree on.

maybe i’ll close this and move to Heaps web-site repo, so i don’t bother the engine people... i’m sorry busy engine people 😢

HeapsIO/heaps.io#68

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants