We should have both stable, alpha and beta versions of the API refs

Now have a very airy and mixed list of Lua modules, and C++ header names under the Api Reference.

I wish to separate the two into a collapsible tree structure:

• Lua modules
  • buffer
  • ...
• C++ SDK
  • dmArray
  • ....

Also, the line spacing is quite high, and I have trouble overviewing the api on a 5K screen.

• The GitHub OctoCat logo in the top right is not retina resolution.
• Same for the tilted editor screenshots next to the "No setup" section.
• The "Turn-key solution" and "Custom configuration" sections collapse badly when I shrink browser width.
• The Forum card under Learn Defold should probably stretch down further?
• On Product, the headline reads "Features", but the title is "Technology".
• The "Hammerwatch Coliseum" image is broken on Showcase.
• The "Look your Loot" image is not retina.
• On safari, the https://defold.com/examples/simple_move/ example opens a crazy huge game instance at the top. (edited)
• If I go to https://www.defold.com instead of https://defold.com I get the angry "This Connection is not Private" phishing warning. Discovered when navigating from the forum back to defold.com from the top bar. (edited)
• The Terms & Conditions link at the bottom is dead. Same for the Privacy Policy. (edited)
• Oh, and the "Truly cross-platform" platform list entries do not align horizontally across the columns.

Currently multiple documents cannot share the same "@namespace".
If they do, only one of these "@document" tags' info will be added.
And, since a document has a separate include file path, this gets wrong quickly.

E.g. hash.h and dstrings.h both reside in the global namespace, but you need two different includes to use these functions.

Need to check and handle absolute image urls

Sometimes on different hardware/browser etc it is really hard copy the code snippets manually (e.g. scrolling + keeping button pressed on a trackpad).

I suggest we add a little "Copy" button to our code snippets.

The API ref currently has two main categories: Lua and C. One improvement would be to split Lua into: Defold (Defold API ref), Lua (Lua language ref) and Extension.

Replace it with a newer game

Just wanted to throw out an idea of adding links to games created by community to https://defold.com/examples/. Some sort of "learn by example" and also "look they are 2-4 years old but they still build and work".

29 games from https://github.com/benjames-171/defold-games could be a great learning material. Last time I tried 5-6 of them 10 months ago they were still working and I learned a few interesting techniques from them.

https://developers.google.com/search/docs/crawling-indexing/sitemaps/news-sitemap?hl=en&ref_topic=9606468&visit_id=638104314783922504-1831273352&rd=1

https://twitter.com/bashkos/status/1201829065138692098

it's not really an issue i made some defold tutorials and maybe they can help the community by adding them to the video tap in defold learning section:

https://www.youtube.com/watch?v=XvSfdu7bcF8

https://www.youtube.com/watch?v=C4JhmQ5bJEI

https://www.youtube.com/watch?v=W0KaY-ucN_U&t=151s

In e.g. render api documentation, the "Constants" section has VERY large text.

Also, I think there is a slight naming discrepancy (Function/Functions, Constant/Constants)
which could be fixed at the same time.

Suggested actions:

• Rename "Constant" section to "Constants"
• Rename "Function" section to "Functions"
• Decrease the size of the constants in the verbose "Constants" section.

material count in requirement of models is no longuer one material so it should be changed

See https://defold.com/ref/alpha/dmHid/

Lossless optimization of images for. Perhaps using: https://github.com/marketplace/actions/image-actions

In the Manuals and Examples, in code snippets where lines of code extend beyond the initial borders and there is horizontal scrolling. Same in light mode.

Hello!
Found a few small bugs on the site.

1. Assets page: Submit Asset button at the bottom of the page is partially covered by the site footer.
2. Foundation page: Clicking or highlighting text on the board members cards opens a photo.
3. Showcase page: Monkey Mart game is not displayed. Fruit Mahjong game is duplicated.

Checked on Chrome for Mac.
Also, as a small wish, I would like to see a link to Defold repository on Github on the main page as it was before.
And thanks to the Defold team for everything you do for the engine!

https://developers.google.com/speed/pagespeed/insights/?url=www.defold.com

When viewing the API reference on a narrow display (for instance portrait mode on mobile) the content extend outside the screen and it is not possible to scroll. Try this link and reduce width of the browser window. Notice that the parameters aren't fully visible:

https://defold.com/extension-spine/api/

In the profiler API reference page there is a typo regarding the available platforms for the function profiler.get_memory_usage() it is written "Androd" when it was supposed to be "Android".

This typo is persistent in all versions, stable, beta and alpha.

{.icon} You can also read the full tutorial text on Github

Make the Twitter share image configurable per page:

https://github.com/defold/defold.github.io/blob/master/_includes/head.html#L66

We can add this to the frontmatter config on pages and fall back to the default image if not set.

On MacOs (Safari) or on iPhones (Safari) front-page image is not darkened when width is < 800 px. The white text could be less readable on lighter backgrounds.

Stackoverflow

Possible fixes:

1. Darken the image in a photo editor
2. Set text-shadow: 2px 2px 1px black, -2px 2px 1px black, -2px -2px 1px black, 2px -2px 1px black; or similar to improve readability
3. Set background-repeat: no-repeat but then it doesn't look good too.
4. Other?

Asset pages do not contain links to the website that is specified in "website_url" from the json file of the asset. So some pages of non-github assets don't have links to the assets themselves.

The YouTube links on the videos page are in the form https://youtube.com/embed/XXXXXXXXXXX rather than https://youtube.com/watch?v=XXXXXXXXXXX, so clicking on the video title takes you to a page like this:

instead of the actual video page:

Find a way to automatically check for broken links. Can this be done when GitHub Pages generates the site?

No results given for:

bob
project
getbytes
dmbuffer

When viewing from a mobile device, in the second section of games with half width image, the image and text extend outside the right edge of the screen.
Browser Firefox for Android, 1080x2400.

https://forum.defold.com/t/get-your-game-listed-on-www-defold-com/64369

• extension-webview
• extension-push
• extension-iap

etc

Check out extension
Copy manual.md and api.md and images

Update status.defold.com

https://validator.w3.org/

See gameobject.h/hid.h

Manually or automatically updated?

It is possible to have a fixed GitHub link to the latest releases and their files:

https://github.com/defold/defold/releases/latest/download/Defold-arm64-macos.dmg

This will redirect to the latest release and the specified file. It would be good if we could use the above kind of link on defold.com/download. The problem is currently that the latest release could be a beta or dev release. Can we set those as pre-releases instead?

Was following the README and got an error when running

python3 update.py --download docs codepad refdoc examples assets

The initial error:

The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.

And after installing Java 8 getting a different error, so looks like Java 17 is required:

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/dynamo/bob/Bob has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0

Logs:

Downloading https://github.com/defold/doc/archive/master.zip to ./doc-master.zip
Unpacking /var/folders/02/fj8dwp59007_d6m9cw6jy9mr0000gn/T/tmpaxpvm4kq/doc-master.zip
Processing docs
...languages
...index
...manuals (en)
...faq (en)
...manuals (zh)
...faq (zh)
...manuals (es)
...faq (es)
...manuals (gr)
...faq (gr)
...manuals (ko)
...faq (ko)
...manuals (pl)
...faq (pl)
...manuals (pt)
...faq (pt)
...manuals (ru)
...faq (ru)
...shared includes (en)
...shared includes (zh)
...shared includes (es)
...shared includes (gr)
...shared includes (ko)
...shared includes (pl)
...shared includes (pt)
...shared includes (ru)
...tutorials
...index (incl. languages)
...shared images
Done
Downloading https://github.com/defold/codepad/archive/master.zip to ./codepad-master.zip
Downloading http://d.defold.com/archive/e0073d0f7156b733e97a53c46924355fbf60dc77/bob/bob.jar to ./bob_e0073d0f7156b733e97a53c46924355fbf60dc77.jar
Unpacking /var/folders/02/fj8dwp59007_d6m9cw6jy9mr0000gn/T/tmp5ryqp6n8/codepad-master.zip
The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.

Traceback (most recent call last):
  File "/Users/mikatuo/dev/defold.github.io/update.py", line 1091, in <module>
    process_codepad(download = args.download)
  File "/Users/mikatuo/dev/defold.github.io/update.py", line 603, in process_codepad
    rmcopytree(os.path.join(input_dir, "build", "default", "DefoldCodePad"), codepad_dir)
  File "/Users/mikatuo/dev/defold.github.io/update.py", line 104, in rmcopytree
    shutil.copytree(src, dst)
  File "/opt/homebrew/Cellar/[email protected]/3.11.5/Frameworks/Python.framework/Versions/3.11/lib/python3.11/shutil.py", line 559, in copytree
    with os.scandir(src) as itr:
         ^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: '/var/folders/02/fj8dwp59007_d6m9cw6jy9mr0000gn/T/tmp5ryqp6n8/codepad-master/build/default/DefoldCodePad'

...

Downloading https://github.com/defold/examples/archive/master.zip to ./examples-master.zip
Processing examples
Unpacking /var/folders/02/fj8dwp59007_d6m9cw6jy9mr0000gn/T/tmp6vmldm59/examples-master.zip
..building app
The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.

Combine all CSS files into a single file to reduce load time