Well, it’s definitely only a very early untested release with the uncountable amount of bugs there are, but that’s to be expected from Roblox these days.
All the bugs, missing elements, and general day one issues aside, it looks rather polished visually and whenever it becomes on par with the current docs site functionality wise I daresay it might end up being even better.
I really like this change, but I have one favor: Please do not delete the DevHub until Docs Site is out of beta! Bugs are being found and already have been posted on this thread, so Roblox, please take your time and fix them instead of rushing the release of this website which is what happened with the Talent Hub.
I would also appreciate it if Roblox reads and acknowledges our concerns regarding this update. I would recommend engineers read posts such as this important one that addresses several key issues.
Additionally, many new features and changes take a long time to get added, and many code samples on the API encourage the use of deprecated functions and some of them (such as the ‘CFrame Math Operations’ article) look like they haven’t been touched in years.
However, if the documentation were to be open-sourced these necessary changes could be audited in by the community without the maintainers having to use a bunch of time doing it themselves, it’d just need to be factually checked.
I apologize if this is an ignorant take and the downsides of open-sourcing these docs outweigh the benefits, but to my understanding they do not.
I liked the old docs better. This one isn’t as good. It’s harder to navigate and it’s harder to get to the docs I want to go to. I’d prefer the old docs. Unnecessary change.
Most of what we currently see is likely final as with many other ‘betas’ in the past, it’s worth voicing your opinion on it, whether it’s in beta or not.
Also, worth noting that the old DevHub will no longer be updated with new API members which makes this ‘beta’ more of a live change that they are calling a ‘beta’ despite the fact that they are already abandoning the alternative.
Bit disappointed that (as usual) any bug report / feature request category won’t allow anyone without the currently unobtainable regular role from posting.
Especially in cases with major updates like this, I usually have to resort to DM’ing a staff member just to have my opinion heard. Would be nice if there was some-way for non-regulars to voice their opinion without just having to hope an admin comes across their reply on this topic.
Loading for many pages on the site is almost instant, which is great for obvious reasons.
Looking up an API reference, the way code samples appear at the top above the properties & functions gives them more prominence and makes them easier to find, as they usually provide what I’m looking for.
The new code blocks also look amazing, and using Fira Mono as the code font is definitely a plus, as I find it easier to read than the old Courier New.
But the lighter background and lighter text than the previous (dark mode) code blocks makes them a bit more eye-straining to read.
Old code blocks
New code blocks
The new search system certainly has a better UI, and it’s great at bringing up relevant tutorials if you search for a specific class, but I also found it’s less tolerant with misspellings.
Old search system brings up the misspelled result
New search system does not
The dropdown buttons for expanding "Inherited from " properties & functions are really nice as well, and being hidden by default makes it easier to scroll past them if they’re not what you’re looking for.
I am a bit disappointed with this update, many UI and UX issues are present like in the Talent Hub. I don’t know whether Roblox is listening to feedback or not but it’s clear that the UI is taking too much space for no reason. The UI is also showing so much unnecessary information that could’ve been optional (like click to expend). I also prefer the centered UI as on wide monitors it’s difficult to read the information because you have to look to the left so much. Otherwise it’s nice.
Looks like a decent update. I think it would be a good idea to have a system like wiki has, where the user base can edit the documentation, fix-typo’s, re-format code blocks, add any interesting code snips, etc… Obviously it will require a team of people with elevated rights to accept any updates posted by the users, but I think the combined knowledge of all of it’s users would be an invaluable resource for anyone about to start creating in Roblox.