#docs-website
1 messages · Page 7 of 1
oh god
why do people do this and not do components right away
I know the answer, because doing stuff in react is a pain
but still
.
^
its centered vertically
I guess the line height doesnt match perfectly
line height doesnt change anything 🤷♂️
It's off by 2 pixels 
or just one, depending on how it should be aligned with the dropdown text 
ok, fuck this, I am adding scss
it just needs some margin
not margin - but the text in the dropdown is just slightly smaller than the label text, which fucks with the vertical alignment just a bit
today is "lets distract martin" day at work, even tho I am not even in office yet (its raining)
but I pushed, I am happy with stuff now I think
gonna get my ass into office for lunch now, can take a final look at stuff after work
not sure what the scope is now, but one thing to note is the custom dropdown isn't a11y friendly
same with the start script toggle buttons
Now that they are components that's easier to fix down the line
All custom UI stuff should be a component
any complains or can we merge?
You mean that site thing? I mean, it, er, works?
Okay, well
can you like, fix the drop down?
would be nice if it just had a constant size if that was viable
What about this?
Just want to know if it would be a good change.
Okay, so, I hate the way that UI is implemented
What would be a good change?
but, you know what
ollie can kiss my machiester
Okay, I have no idea how you'd spell what I was thinking in a translable manner, but, ilyollie
but, yea, I don't care about the UI dropdown enough to do anything about it myself, so, lgtm
Ah he was talking to Martin
I saw it earlier too, fucked around with it a bit but only made it worse (i.e., went off screen, text went outside the container, etc)
scaling absolute positioned stuff is fun
Looks good to me, lemme merge it
I recall there being some flex tricks you can pull off, but, like, it's friday
be my guest, lol
I hate flexbox
friendship with flexbox ended
grid is now my best friend
Let Martin work on the important things again.
I get the feeling that going on a web dev course is going to be my undoing
Thanks
Until the next ui concept comes.
grid took us a hot minute to implement, lol
iirc it was experimental in chrome for 5 years
which is part why its so good, its just so well thought out
@neon epoch !!! emergency!!! https://i.imgur.com/nN8yOIC.png help
you broke the front matter
I thought the terminal was interactable now, wasn't that merged?
imports can go after front matter
Website doesn't deploy automatically
oh right, I thought it did. why isn't it automatic?
Maybe I'll get my ass up later
It runs on the legacy server
We are in the progress of moving shit
(i.e. Riley moved java ducks while I was way)
well,m the deploy script broke
but it did deploy
I blame @drowsy zinc full name
error! {
"message": "The request body contains invalid JSON.",
"code": 50109
}

oh refresh was broken
also double quotes please
prettier doesn't run for doc files so it's me who's gonna poke you
%%_MAJ_MIN_MC_%%
yes that
since I just fixed a similar bug in hangar by just setting w-max on the container, this is how it would look like for docs:
hangar can get away with w-max since we use a bunch of JS (in form of a lib, popper) to position the popup
No
maintaining 20 dozen different versions of a piece of ever evovling piece of documentation is generally just not viable
i18n in general is a royale headache in the first place in anything that isn't just raw text + placeholders
We'd also then need like 20 people on the ball to deal with updating stuff within a day or so
like, it's a commitment rabbithole
I do want to fix i18n for hangar tho, thats easier to maintain since its just words or maybe a sentence at most
Yea, but t'is hangar, not docs
for stuff like hangar where you generally have a predefinable list of strings and templating, it works
there is a reason why wikipedia basically just maintains full pages for every article of different languages
they're not even translated in a 1:1 manner, sometimes the pages content can just be wildely different
no
rude
Wow
I guess I’m not welcome
I thought about that but adventure has a latest tag, so it's pointless to version it manually
ok sure
I could make it work with the component and the latest tag, but I found it shorter with just plain markdown links
this also probably needs some rewriting.... I did not know it existed so i didn't cover it xd
https://docs.papermc.io/paper/dev/internals
oh yeah. if you could chuck a PR or issue that way, would be appreciated
The final missing thing was added for the converter (is also why I blocked before): /convert-entity-argument endpoint with an additional entityType request param, so that mode needs an additional input box
Could even make that a proper select/search for the existing entity types, but that'd just be a nice to have
meh ill add popper for the selects
lmfao
/summon armor_stand ~ ~ ~ {ShowArms:1b,HandItems:[{id:firework_rocket,tag:{Fireworks:{Explosions:[{Type:1,Flicker:1b,Trail:1b,Colors:[I;11743532,4312372,14602026,8073150],FadeColors:[I;4408131,2651799]}]}},Count:1}],HandDropChances:[0f]}
Copy the nbt part from that, /convert-entity-argument?entityType=armor_stand
now lets see if I can give the select the same popper treatment
exuse me, floating ui treatment
lemme see if I can get keyboard navigation working on the select
autocomplete already works
ok now am happy
did I spend too much time on this? maybe
would this have been easier in vue? absolutely
mfw thats hundreds of lines of code
@vocal halo what kinda masochist are you that you use arrays with mixed data types instead of objects, lol
like who is supposed to understand this code? 😄
oh so its not your fault
I thought it was the way to go since it got merged before
does a git blame
there was a comment but it was ignored it seems
I remember the comment
well, I am fine with merging your stuff as is, but it should really be cleaned up afterwards
its tedious work, I can do that if nobody wants to
Well it is an interface no?
I want proper fields, lol
But the comment wasn’t ignored per se
I’ll try to change stuff later. It’s my first time with this stuff so can take a while but I gotta learn this shit anyway
basically just stuff like
export interface CommandData {
/** The permission node prefix. */
[0]: string;
/** List of all commands under the prefix*/
[1]: Command[];
}
// to
export interface CommandData {
prefix: string;
commands: Command[];
}
which then means changing stuff like this
export const bukkitCommands: CommandData = {
"0": "bukkit.command",
"1": [
["help", ["?"], 0],
["plugins", ["pl"], 0],
["reload", ["rl"], 4],
["timings", [], 4],
["version", ["ver", "about"], 0],
],
};
// to
export const bukkitCommands: CommandData = {
prefix: "bukkit.command",
commands: [
{name: "help", alias: ["?"], opLevel: 0],
],
};
with multi cursor editing doing all the changes shouldnt be too bad
Holy cow is the second one an improvement. No doc needed to understand.
self documenting code is amazing, isnt it? 😄

so thats where the masocistic behavior comes from 😄
No kink shaming Mini.
Yeah, that's my way as well. Clean Code! I even add a local record in java to avoid anonymous Tupels. Instead of using a fairly big lambda I extract it into a method. 🙂
I am not! before we had no docs on this, so the PR is appreciated no matter what
Oh Janet..

the hard part is listing out all the data, changing the data into another structure is easy
ya that's what I meant with the comment originally
jds page needs to link to https://jd.papermc.io/paper/1.20.6/ now
what page
software/paper page
does it have to? why doesnt /1.20/ just point to .6?
True lol
I guess he just forgot? @opal flare
there’s an issue
no the javadoc itself got a slight change in java 21
We wanted to change 1.20 to redirect to 1.20.6 I think
Serving the same content under two urls is bad for SEO and bad for caching
Best Michael
I had an idea for it but not really sure how to properly implement it, first though was something like version groups like the API has or somehow with regex ors omething
@spice temple i converted the interfaces to proper fields now.
Looking nice!
wym with the review
opLevel as a string doesn't make much sense, idk what that text represents, am on mobile, but I would put that into its own field
I remember the tsdoc having come kinda if it's a number it's this, if it's a string it's this, just have two fields for that
can we somehow make them mutual exclusion?
Uuuhm, most likely
There isn't much you can't do with type gymnastics
Is it worth it? I don't know, lol
Oh can just use two subtypes
And the an union
This doesn't look too bad
Can we resize this @spice temple , so that Component Doesnt get wrapped? It looks fine when the others are selected as the box changes size
There is probably some manner of turning taking advantage of the min width to try to limit it expanding
oh right I wanted to try that now that I use popper
excuse me floating-ui
lemme put out this fire at work and ill take a look
I could swear that I run prettier before it pushed
haha, if I get round to merging it before you do, ill just do it myself dw
ok microsoft isnt doing anything so might as well look at this again now
Thanks ollie 🤝🏻
Perfect
Woo
Too fast and CI failed, or...
well, idk if anybody wanted to look at stuff ^^
Just in time so that you can do the next (and hopefully last) pr 
im gonna go on strike from merging things
u did the backend?
Yeah but I pushed most of the work onto you™️
/convert-commands takes a json input {commands: <list of strings>} and returns a list of strings
you need to trim input lines and skip them if they start with # or $, but here's the fun part:
do i need to rollback
nah this is a separate thing
Check CommandFunction.fromLines, mcfunctions support multi-line commands via \
I don't think we care enough to output them split again, but it might be nice to be able to at least take them as input
So basically this block https://i.imgur.com/ywxZfrO.png
oh its indented?
no clue™️
I cannot find any documentation on this on either the mc wiki or microsoft's own docs
and context on the other symbols is that # marks a comment and $ a macro (should also skip empty lines), but we don't handle macros
you could send them anyways if it makes output easier, but it'd be wasted processing on the backend
also also, it's worth nothing that the file you sent me would barely be converted at all because the only entity argument in a full command we can convert is summon, otherwise we don't know the entity type, but 
we ruin any whitespace I guess
good enough for today https://github.com/PaperMC/docs/pull/376
will think about stuff
kinda meh that we cant infer the entity type somehow
Storing the indexes of (non)whitespace lines should be simple enough
yeah
but yeah I think we can merge without multi line handling and maybe worry about that later
I asked the guy for an example
ollie is ruining my beautiful pr names
Yeah real.
Avg idiot
Without looking it up I know what it is, lol

Thankfully the ad removal mod I use for twitter breaks replies
So I can't view them unless I open the tweet in the browser
There's another https://x.com/Roark_Cats/status/1787306914701021247
except it doesn't seem to handle commands, entity data, text components, or most item-specific nbt? 
they also just implemented the migration stuff themselves; https://github.com/misode/nbt2components/blob/main/src/components.ts
interesting
We gonna need Ollie to make monthly Infograph on how our traffic is looking like on the doc site
its trending down
Hell I saw this and I can't unsee it xD
Can someone update this to the new dropdown?
aka the one used in the converter
Also, slight visual bug, it shows Enter your 1.20.4 command here... in all modes
Not true, for the new function mode I changed it ^^
you sure?
what is this?
Not merged yet
Good first PR 😛
Should be easy
i'm not sure ollie
that API is literally just the TeleportFlag class and the teleport methods, it's quite obvious if you read the doc on those imo
Hell, I suppose xD
it seems to be already in github lol
probs not pushed to production
Well then I am confused lol because the Select component used in the start script gen is the same as the one in the converter
lol
do we have a command api page yet
confusion
It's not used for the platform yet tho
for CommandExecutor, Command(CommandMap) & in the future the brigadier command api + maybe mention a few libs?
Isn't that the only issue?
oh shit ye, gonna PR it
Does the Select component require the value?
I suppose I will just set the default to linux
like it is.
Ollie wants to wait for brig
Can anyone check if this looks good? https://github.com/xMrAfonso/papermc-docs/blob/main/src/components/StartScriptGenerator.tsx#L220 I honestly have 0 knowledge with react
lol
Gtg eat but will do it afterwards
just checked preview and page crashed oof
yeah noticed, although I didn't add anything related to label so I am confused lol
only modified this
And added the PLATFORMS const
a couple more changes had to be made: https://pastes.dev/2DDgaBknFh
what did you change? or am I just blind
string -> Option
ooh
yeah
me dumb
just added the changes to the PR, thanks! Waiting for the preview
to make sure
works, should I add some spacing between the auto-restart and select menu?
or is it fine like this
seems a bit tall any way to make it smaller?
it's as tall as the fields above it
yeah but it doesn't fit that well here imo
waht about puttin the select menu into a seperate line?
maybe even add it next to flags and filename
something like this maybe?
yeah that looks pretty nice
is the auto-restart centered?
yes
yeah I also thought about that but I'm editing this in devtools :p
oof xD
i think i would still prefer having it next to the other selection menus though. so we have 3 selection menus next to each other and the toggles below
you mean like when toggled on it has a blue background otherwise black/grey one?
Something like that
Then you could put those 2 on the left and platform on the right and it would not look weird
maybe
i like the idea though i am unsure if that's intuitive for the user
Button for toggles aren't great imo
I think this looks pretty great
i think it's kinda odd though because how do we decide what comes into this upper portion of the gen
and what comes down here
because platform is even more important then flags so that should be up there aswell right?
💡
Can platform auto-detect the users platform?
no
And default to that? then it wouldn't need to be changed a lot
i mean what if they just ssh onto the linux server
I mean it could use the user agent or something, it doesn't right now
linux users are hopefully smart enough to find that dropdown
why is that useful though? it's probably not going to be used in the user's machine...
i mean yeah but it still seems weird
like 98% of the time
isn't linux literally the default?
I feel like 90% of the time that pages is used by people who otherwise double click the jar on Windows
oof
at least 90% of that page being linked in the help channels here is that
so how we feeling about this one?
i really like the toggles on the right but the platform still seems kinda out of place
xD
do we actually need the platform label? xD
Labels are important for accessibility
just for testing
could you try adding it next to the filename and flags i wanna see what that looks like
because having all that area for 2 selections already seems pretty emtpy
so, have filename, flags and platform in the same row?
yeah
if I do that, isn't it going to be even more empty?
i mean all that area here
maybe try keeping the gui and auto-restart in 1 line aswell
that seems really nice
might be too compact though
I will just push it to the PR and see what happens lol

although me and naming classes sucks, what should I call that row with the autorestart, etc.
since I can't modify config-section since all of them use it
hmm call it "toggles" for now ig
It can tho?
Literally can drag and drop them in the elements tab ^^
But why don't you start stuff locally?
this looks pretty good imo
cause... uhm... I didn't think that far lol
eh
yeah i expected it to look a bit better
toggle boxes should be aligned
this looks good
yeah i didn't realize afonso pushed so i just did it in inspect rq after mini said you could drag and drop
well this also looks good
yeah this is best one imo
god damn prettier lol
I like how there's like 5 of you bike shedding the location of 3 inputs
real ui design
frfr
hehe
why is server configuration so big?
UX is very important
shouldnt there be another header for the output?
I am so happy I have a professional doing it for me at work, lol
tbh yeah
like generated command is not really a server configuration
She's a god send
someone should probably add a githook that checks before you commit
because no one can keep the code consistent
oh have i had my fun with ci complaining about formatting in the past 
It's important to have consistency plus it reduces diff
Just configure your IDE to automatically run it?
(format on save)
Right click on the package.json -> apply prettier code style in intellij
Then your normal format shortcut will run prettier
too much effort compared to deleting a single file
do that on a codebase that doesn't use formatters and you got yourself a 100 line pr consisting of formatting changes lol
I hate pre commit hooks, they slow everything down
Running it locally rn btw
that's just a skill issue on behalf of the hook writer
One team at work put the unit tests into a pre commit hooks
Like wtf
That's what we have CI for, I ain't got time to run that stuff locally
unit tests are for losers just do everything as formal proofs 
should have used pnpm
isnt the docs website pnpm
where is difference between pnpm and npm again?
they're different package managers
don't have it lol
but who knows
but pnpm is based on npm right?
enable corepack and your runtime should download it
node ecosystem loves duplicating a bajillion package managers
so it must have something to offer that npm doesn't
performance
makes sense
th is that
using npm in the docs repo is going to be slow because it has to resolve from scratch without a package lock json
oh yeah
faster
i remember seeing some rust repo that had the cargo.lock file in their gitignore 💀
why not?
faster
i honestly also thought that .lock files shouldnt be tracked but i dont really have node stuff anyways
even less rust projects
the lock files "lock" the dependency versions
i guess this is a TIL moment
bearing in mind that the standard way that you note versions in some of these tools is generally far too open for build reproducability
wait are you going with that design?
i personally like this proposal more though that one also looks good
idk, I am asking lol
this is what I have rn
ALSO, why in the world are we using pixels?!
for what exactly?
ollie
using px for dimensions should be illegal
afaik pixels as measurement are used all around the place at least on the website
tbh it shouldn't
doesn't look bad
hmm interesting didn't know that. though i ain't a css expert
1rem = 1 * fontSize
so people that use bigger font sizes, everything would adapt to it
could we make the copy to clipboard and download button into little buttons in the top right corner of the text field?
time to find out where I can change their size
lol
why should they be
i remember seing that on stackoverflow or mozilla docs somewhere
they're the primary reason you're going to the page
yeah but they kinda look disconnected from the text field
(i am just brain storming here, just trying to find out if stuff looks good)
also i think you might need to repurpose your pr into something more generic lol
^ from mozilla docs
we could move the Generated Command to where the JS is
hell too much work to know if it looks good lmao
they are placed in proximity to the text field
fair
might try that if i find time to
looks good imo. up to your to decide which proposal you wanna go with
i suggested that all the way back when the generator was proposed for the first time
completely forgot about this part, looks okay
and what did ollie say?
ohh that might be a problem
having the warning in 2 lines in middle of the screen seems kinda weird
we could actually use the descriptions in the dropdown to say that linux is recommended?
oh yeah
question is... would it have the same effect?
hmm can you make the text in there red
. is probably going to look shitty but who knows
i dont know if we even have to add this red text
uh don't think I can directly, it's a component
like if you want to generate a start script you most likely already decided what platform you want it to run
yeah that's fair
good idea
(is my grammar good there? lol)
but windows needs to have a different text
looks weird
any suggestions?
those were generated by copilot xd
you could just leave the text out
we don't recommend mac for optimal performance
and that
also am i tripping or is the bottom white darker then the one on the side?
but if thats the case than the solution before didn't really make sense either, since it doesn't show when selected linux/mac
and you could still have generated it for mac
and would not have the "warning"
also /bin/bash shebang is wrong
#!/usr/bin/env bash is correct 
i should probably PR that in
you are in fact tripping
they are the exact same
tf they look different
oh the white
yeah
was gonna say that I can probs fix it with this PR but probably best to not merge unrelated PRs I would assume
what am i looking at
are you high 
wait the closer i get to the monitor the brighter the bottom one becomes and the darker the side on becomes
I agree they look different
i think you monitor is broken
bro
I’m looking on my phone and they look slightly different, but not enough to care
also your two whites are over different backgrounds
also why is this still a pixel off 💀
Speak to the person that made the font
they are indeed the same
@neon epoch fix it
this is going to haunt me for the rest of my life
lmao
well whatever it is time for me to go. cya
No
so we good with this?
yeah looks good
although prettier check failed again although I ran prettier?!
lol
We areee the champiooonnnssss
Have you tested the user linking @drowsy zinc
what if it breaks
Good night
That’s for tomorrow Ollie not tonight Ollie
All I know is that knowing that it's ollies problem and not mine makes me happy

Bahhh it would have rolled back
1.20.6 is now stable (I’m editing this now to just mention this was a joke at the time)

any reason we don't show how to get the lastest minecraft version there?
What like that?
no i meant like in addition to showing how to get the latest build also show how to get the latest mc version
so basically just replace the "1.20.6" with a curl request to that api endpoint
well it needs to be adjusted somewhat anyways
it should filter by the highest stable version, and then return that, but yes in essence it shoukd
does api return if a version is stable?
major? i think it just returns if a minor is stable
build that is
^
it returns for builds iirc
it is technically correct, because it prints Latest build is null :p
so it's broken? 
there's no latest stable build, so it's null
could modify the script to print a different message
i mean sure ig lol
I mean, it is fair. Even if you auto update you are not mad enough to auto update minecraft versions
hmmm.... surely nobody would do that
We can change the "for the given project" to "the given project and version. If no stable build for said version is available, null is yielded"
i'll modify the script as well to make it pretty :)
Ohh, you sure about that? Because I am not
Next up in paper 1.21, an .exe jar that automatically download, install java21 then create the folder and start script for the enduser
give me my .exe! Smelly devs!!!!!
I was bored, so I made a script for searching for the latest stable version, but I don't think it should be incorporated into the docs 😛
#!/usr/bin/env sh
PROJECT="paper"
while read -r VERSION; do
if [[ "$(curl -s https://api.papermc.io/v2/projects/${PROJECT}/versions/${VERSION}/builds | \
jq 'any(.builds[]; .channel == "default")')" = true ]]; then break; fi
done <<< $(curl -s https://api.papermc.io/v2/projects/${PROJECT} | \
jq -r ".versions | reverse | .[]")
echo "Latest version with a stable build is $VERSION"
API v3 will be changing things too :3
oh? 👀
what's up with this PR to make paper javadoc point to latest version? It looks like it already does?
this button points to 1.20 which is latest version in the 1.20 family
So basically, I’m not sure why this was suggested to do, but 1.20 points to 1.20.5 instead of .6. I thought we were just gonna update it to point to .6 but idk what’s happening with that
that is a javaducks issue no? certainly nothing we'd want to fix on docs or the website
oh you're right, it does point to .5
I thought 1.20 was just supposed to automatically point to latest
yeah, I don't think this is a website issue then, shouldn't be "fixed" there
Yeah, that’s why I haven’t done this before. I think we pinged Riley about it but I’m not sure he saw
aha
ok
well I did look around for a bit but i guess i didn't look in the correct repo out of the 50 you have
lemme try to conf this locally before I commit
the infra repo with the config isnt public (yet)
the world isn't ready for it yet
and it doesnt even count yaml
well i see it positive, without my PR people would still have not talked about it
and 15k of those are k8s
like, its half a mb of yaml
thats funny
to be fair
ah yes javaducks is also on that one account
90% of that is just flux generated kustomizations
the fix is probably somewhere there
as I said, we just need to configure javaducks
ok ez, figured it out
cool its broken 😄

how’d you configure it
iirc the link has to be a full url so https://jd.papermc.io/paper/….
at least that worked for me
the sha255 errors can be ignored if they don’t have a .sha256 file
its doing dum stuff somewhere
it’ll fallback to sha1 if configured properly
can’t remember what the default was lol
thats not my issue
the logic is wonky somewhere
the redirect needs to be last
else it ignores the stuff after it
redirect last:
redirect before the other 1.20 versions:
found it
and this ladies and gentleman and everyone in between and outside is why we don't like long as methods with tons of control flow statements
Where was it?
in my defense, it worked locally for me
@opal flare when you get around to merging you can revert my revert on infra, lol
https://github.com/PaperMC/infra/commit/06dcd3f775233250cc8b4c0cca9ccce3a92a2ab0
yeah, it worked when I tried too, thats why I pushed to prod
its subtle, it will just stop parsing
after a release or redirect
I blame the code, not you, nobody saw it in review either
ha
we actually had to use this plugin once in homework
keep everything below 7
we had a legacy application having the whole code in main and we had to use solid and patterns to split it up
tried to split stuff a bit and also added tests
Why is it British 
should also work on your other pr (:
will rebase that once this fix is merged
not me taking a million force pushes to fix the tests on gh
dum race condition
riley merged my PR and reverted the revert of the config, now paper/1.20 redirects to paper/1.20.6
https://jd.papermc.io/paper/1.20/ now redirects to the latest version in the 1.20 family
https://jd.papermc.io/paper/1.20.5/
https://jd.papermc.io/paper/1.20.6/
Other older versions are unchanged.
oh I should rebase the injection PR now
(did you read my comment?)
idk if thats necessary, we can just let it 404, no?
if we dont add the injection, its gonna 404 anyways
no harm in doing the injection
From my testing if a favicon doesn't exists the whole page throws an error
yeah that I am fixing rn
I kinda wanna add an injection that adds a banner ontop saying "you are viewing javadocs for X which is outdated, click here for Y, which is latest"
but thats a different PR
raised https://github.com/seiama/javaducks/issues/14 for discussion
added tests to https://github.com/seiama/javaducks/pull/4, rebased, fixed the 500 on missing favicons, its ready to merge now
straight to prod
having read all example code provided, it has now occurred to me that paper's api is too complex to understand just from looking at it anymore
Shorten to "DANGER: Owen wrote this"
https://github.com/PaperMC/docs/pull/307 If anyone wants to work on this, feel free! would be useful to have in place before Brig docs :)
Just PR to my branch, or supersede and cherry pick my commit
@neon epoch can u update the feat/lifecycle-api branch? I'll add to it, but it should either have main merged into it or rebased on main
Tada 🎉
(There is a button on GitHub for it)
Isn’t that refined GitHub?
Oh ok
@spice temple halp
that link doesn't work, you need the full version. https://jd.papermc.io/paper/1.20.6/io/papermc/paper/plugin/bootstrap/BootstrapContext.html
oof
will fix
kinda is a WAI no?
no
I mean, not retaining path is generally dumb if the sole goal of the redirect it for linking stuff over
like, it breaks the site, for ex
Expected :/paper/1.20.4/org/bukkit/UnsafeValues.html#checkSupported(org.bukkit.plugin.PluginDescriptionFile)
Actual :/paper/1.20.4/org/bukkit/UnsafeValues.html
mmmmh
guess redirects cant contain those?
oh wait my fault
ah wait the fragment never reaches the server
was gonna say
pretty sure that # only exists on the client
you'd need to do a JS redirect to handle that afaik
Well, the big issue is, what are we using on the website?
mmh
I don't know if we are doing method/field references direct yet
just types so far I think
but that shouldn't be the end all be all of that
well, guess JS shit it is then
Many people here are linking directly to methods
that isnt an issue, if the link is fresh
I mean the docs should just use the current version, not the family versoin
should just be updated to special-case for paper
the majorOnly parameter is also a weird special case for velocity
I didn't look at it too closely when I refactored that file
the entire versioning thing (SoftwareVersionFetcher) should be looked at
I was thinking there would be some cool stuff we could do to make it way easier to inject javadoc links
like at build time, it resolved the full package of a type or the full url for a method
so instead of having to do <Javadoc name="some.super.long.package.Type">Type</Javadoc>, it could do <Javadoc name="Type">Type</Javadoc>
the majorOnly could probably be removed and just make a if statement for the different versions?
classes with the same name can exist, I don't really like that
yeah, ik they can, but that could just be an error on build or smth
it just makes it way nicer to work with when writing docs so I don't have to look up full packages
it's not that common that there are collisions anyways
I'd rather keep it simple and just use full packages, guesswork for docs is meh
WOW
man just wanted to avoid being flashbanged
next up... there could to be a header on the javadoc page to change versions
ok, I'm good with the lifecycle api docs
Cool lemme look
Thanks MM - I changed some of your wording cause it seemed like a bit of a ramble at points 
Hehe, that’s fine. That bit blurb on the bottom I just copied and pasted from the gist I wrote months ago
yeah it seemed like it, especially when it was in the first person lol. Thanks for doing it though ;)
thanks lynx, lol
just no one check how many force pushes that was
maybe I should look into setting up a dev container for docs
installing node bs on my system pains me too much
that page in itself seems flawed compared to just redirecting to the script generator from the start
Maybe we should make the start script thing a note
instead of a tiny line
beyond that, we can quickly fix the bash script with a couple of \ s
how many force pushes does it take lynx to do that :P
I-
yeah bout to do that right now

considering the person who took the charge with managing the docs site
why not omit the flags from that page completely?
I'm guessing it's a leadership issue
it's an explanation page for them, I don't think that the UX issue with the specific impl there really nececitates neutering the docs page here
to be fair
their issue wont be fixed with adding \
personal issue 
xd
if the note successfully stops the end-user from blindly copying the flags then i digress
I mean, we can instead yank the paper.jar --nogui thing and replace it with .....
hammer home that this is not a real command
could make it possible to select the flags, but not everything around it? e.g. make paper.jar --nogui non-selectable
oh yea, that might be a vibe. Tho, maybe not selectable at all?
i can see the ease of use of just triple clicking the codeblock for the flags
that sounds rather overengineered
what is copying the flags going to help you if they have new lines
I don't mind the non-selectable
make it an image xD
makes it pretty clear they are not to be copied
ssshhh i wasn't able to be a part of the bike shedding from earlier
it's my turn to nitpick little things /s

agreed
add a copy overlay which copies the correct string?
can we not set the overflow behavior to deal with that without newlines?
We could yea
I don't think that making the site UX there worse is the solution here
people are going to want to copy it because it's just a common ref point
on hover, add a clickable overlay that sends you to the generator 👀 /kidding,not kidding
works for me
Who the fuck knows how that works
docusaurus has an open issue about setting the initial word wrap state on code blocks, not possible right now though
yea
yeah, just replace newlines with a long string and then let the user use the automatic wrapping in the docs
my issue got fixed pretty quick tbf, but it was a simple fix
are you working on something for javaducks again @spice temple?
no, I am distracting myself with other stuff rn, will get back to my open PRs next week
the rich presence stuff is super buggy when you have multiple IJ windows open :/
so https://jd.papermc.io/paper/1.20/org/bukkit/plugin/java/JavaPlugin.html#onEnable() still doesn't work
it keeps the #onEnable(), but it doesn't keep the org/bukkit/plugin/java/JavaPlugin part. @spice temple
oh wait, was your PR not merged? I thought it was since the #onEnable() part was being kept
ok, I think this is a good bit for brig API docs https://docs-cmvikok3y-papermc.vercel.app/paper/dev/commands
I submitted a docs pr that uses the version without redirects
wat
why
how
well, yeah, lol
my PR isnt merged yet ^^
will work on my open PRs for javaducks and docs later today
Should there be an example of how to add an argument to the command? That isn't shown in an example yet and I would think an example could be useful.
already added a review command about that earlier ^^
https://github.com/PaperMC/docs/pull/386 in case you wanna add anything else
Hmm alright, only saw the review about the BasicCommand example (https://github.com/PaperMC/docs/pull/386#discussion_r1597991624) but nothing about arguments. Maybe I misunderstood this comment though
oh maybe I missunderstood
I guess my comment below that goes into that direction, but doesnt hurt to add another comment 🙂
ollie breaking docs
No, Riley merged it
how exactly is it broken
so its not broken, but when we version for 1.21 it will not work and place 1.21 versions into the 1.20 docs
iirc it didn't do that before either
Pretty sure it did, i remember testing it at the time
there was some logic to extract the version from the current url but it was never used
I mean it worked at one point when i tested it
I extract the version from the URL (definitely a better way of doing this i think) and then if it matches, take the highest from that version group
so we dont need to revert?
if its gonna be an issue in the future, we need an issue on the repo so we dont forget
I mean in an ideal world the repo would be reset to bba4d0416132280e370f24eed4f5c158494bea27 and then scorp could reopen their PR, but i can't force push last time i tried so if you wanna do that Mini you are welcome to
its not an imminent issue though, just needed some more work before merging
just push a revert commit?
ugh just the idea of 5 stupid commits cause of the revert annoys me
I don't mind force pushing
cool
Yeah no worries lol, i'm in the library till tonight
isn't it monday? :P
I left work at 1 today because I didn't feel like doing stuff, lol
I did get my car cleaned and I did chill in the park tho
they don't care that you just leave?
ollie with the american grindset
is it more of a "as long as x hours are done it doesn't matter?"
I clock in and out, my contract says I need to work 7.6 hours per day, but I can go down -20h and +50h
I mean, usually its more like "is feature x done"
at least on my end. Results matter more than the time you put in
You don't track time? That's illegal in the EU, just fyi, lol
Oh, yeah
ah ok fairs. my only real work experience is (1) mcdonalds (2) a web dev company that did 9-5 mon-fri
I can work from 6 to 22 and if I ask nicely I could even work on Saturdays
I can also work wherever, I have a coworker that sometimes rents a cabin in the woods and works from there, lol
On my last vacation I met a girl who worked for a bank in London, did half days for her whole vacation, lol
She would chill in meetings next to me at the pool
I wouldn't recommend doing that, that's not what work life balance means, but still, perks of working in IT
man I hate non linear history
pushed
Wait why a force push?
to remove a PR merge
cant you just do a revert commit?
ah
what's being reverted?
can't you just revert the merge commit only?
idk, I don't know how non linear history works
probably it just fucks up the commit history
my fork's main branch is done for
reopened as draft, I'll actually fix it in a few hours
just delete it and check it out again
i'll just hard reset it and force push
both https://github.com/seiama/javaducks/pull/15 and https://github.com/seiama/javaducks/pull/4 should be good to go now
th is javaducks
the software serving the javadocs
looks nice another thing i could imagine looking nice would be having it be "pop up" on the header bar
that would look weird on mobile I assume
its also harder injection wise, harder to look good, etc
What's with the rounded border?
edge
ah



