10,000 Matching Annotations
- Oct 2022
-
www.youtube.com www.youtube.com
Tags
Annotators
URL
-
-
-
Options to import/export locally stored passwords have been a staple of Chrome for years. For god knows what reason either option seemed to randomly disappear in one Chrome Version and then re-appear in the next.Sometimes there was an import option with no export option, sometimes the other way round like right now, sometimes neither option was available, but you could always add either Option via chrome://flags.If they wanted to force people to use online sync only, why have options for local export still, but not import?
-
-
stackoverflow.com stackoverflow.com
-
You can even simplify this with the *** pattern that was added in version 2.6.7: + /mnt/ + /mnt/data/ + /mnt/data/i-want-to-rsyncthisdirectory/*** - /mnt/** This operator allows you to use the ** wildcard for exclusion and consequently to have only one exclude line.
What does * mean? And why is it used in the + line but is used in the - line?
-
which failed to work because of the trailing slash before the **. Removing the / made it all spring in to life as intended!
-
-
-
nickjanetakis.com nickjanetakis.com
Tags
Annotators
URL
-
-
nickjanetakis.com nickjanetakis.com
-
I had to do 13 steps just to get to the point where I can start writing. To make matters worse, I often compulsively close terminal windows after I am done. This is a process that gets repeated single every time I feel like writing.It’s actually a huge barrier of entry. Sure they are trivial tasks, but they take up a whole lot of mental energy.Living the good life is not all about money, it’s about avoiding stupid things like having to perform a tedious 30 second routine just to get started working on what you want to do.
-
-
-
-
askubuntu.com askubuntu.com
-
Note that fixing a deleted ESP requires re-creating not just the ESP itself, but the boot loader(s) that it used to contain. Such a repair will require the use of an emergency boot disk, like an Ubuntu disk in its "try before installing" mode. You'll also need to restore all the boot loader files. In the case of a Windows/Ubuntu dual-boot, this means recovering both OS's boot loaders. To simplify this task, I strongly recommend backing up the ESP. A file-level backup (using tar, cp, or similar tools) should be sufficient.
-
-
-
In all honesty, I haven't had the patience to experiment with the latter in order to gain certainty about it. Ditto for trusting the boundaries of firmware settings and booted drivers. Indeed, I don't really trust the standard 'buntu installer to reliably ensure that the external drive will even get an ESP partition - at least, without being explicitly told by a custom partitioning step.
-
-
www.reddit.com www.reddit.com
-
Yep, the easiest thing is to create a second EFI partition: https://pop.system76.com/docs/dual-booting-windows/It is still possible to encrypt your popOS ext4 partition using LUKS and LVM, though this won't just work out of the box.
-
-
www.linuxquestions.org www.linuxquestions.org
-
I'd like rsync to create the source dir structure on the remote, when I'm only synching a file in a sub-dir. At the moment it seems I need to do this in 2 commands, e.g.. ssh <remote> mkdir -p /backup/var/spool/cron/crontabs rsync -vauz /var/spool/cron/crontabs <remote>:/backup/home/var/spool/cron/. Ideally, I'd like to be able to do this: rsync -Mvauz /var/spool/cron/crontabs <remote>:/backup/home/var/spool/cron/.
-
-
www.linuxquestions.org www.linuxquestions.org
-
I'd like rsync to create the source dir structure on the remote, when I'm only synching a file in a sub-dir. At the moment it seems I need to do this in 2 commands, e.g.. ssh <remote> mkdir -p /backup/var/spool/cron/crontabs rsync -vauz /var/spool/cron/crontabs <remote>:/backup/home/var/spool/cron/. Ideally, I'd like to be able to do this: rsync -Mvauz /var/spool/cron/crontabs <remote>:/backup/home/var/spool/cron/. ...where M (make parents) is a new option that tells mkdir to do 'mkdir -p' on the remote target dir.
-
-
askubuntu.com askubuntu.com
-
refused connect from [IP-ADDRESS] ([IP-ADDRESS]) This particular message is emitted by the TCP wrappers library when it decides to reject a connection. Ubuntu's sshd is built to use TCP wrappers. Check the two files "/etc/hosts.allow" and "/etc/hosts.deny" on the ssh server. You have an entry in one of those files which causes ssh connections from that address to be rejected. See the Ubuntu man page for these files.
answered question: error message in logs but don't know where coming from
-
-
www.quora.com www.quora.com
-
Going first through an inverter from 12 V D.C to house hold 120 or 240 and than back again to laptop charger is very inefficient. You have the magnetization losses of both the inverter and the charger, which could be 8 or 10 VA each , it does not sound much but 16 VA at 12 Volt = 1.33 Amps without doing any real work for you.
inefficient
-
-
stackoverflow.com stackoverflow.com
-
With JSON Schema, you don't have to specify things. The syntax is declarative and adds restrictions. So if you don't want a restriction on the type of value that's allowed, don't use the type keyword.
-
-
-
www.imdb.com www.imdb.com
-
Just because a movie is what people call "cliche", doesn't mean its inherently bad.
-
-
blog.unity.com blog.unity.com
-
Why is the price of my Unity plan changing? The new price reflects the value of our products today, and it’s our first increase in almost three years. In that time, we’ve expanded our R&D resources by 172%, with the Unity Editor being our largest focus for R&D investment at Unity. This continued investment has helped us deliver Unity 2021 LTS with powerful improvements to workflows, rendering capabilities, and supported platforms. We will continue delivering improvements based on your feedback in every release to enhance your productivity, performance and stability.
positive spin
-
-
-
I expect RuboCop to either make no suggestion on how to resolve the ambiguity, or to suggest something that does not change the semantics of the code as it stands.
-
However, the code as it stands associates the block with bar, and if the code is currently working, the programmer should definitely not parenthesize the parameter, because it would change the meaning of the code.
Tags
Annotators
URL
-
-
github.com github.com
-
A better message, clarifying the true purpose of the cop, which I guess is to differentiate empty Hash literals and blocks.
-
But this sounds like spreading fear and doubt when the Ruby parser has no such concepts :) {} always binds tightly to the call right next to it. This block {} will never go to using, unless it's rewritten as do ... end.
-
-
github.com github.com
-
That's actually a false negative if it doesn't trigger the cop but should; a false positive is when it does trigger the cop/test/fire alarm/etc. but should not.
-
-
en.wikipedia.org en.wikipedia.org
-
new top-level element for describing Webhooks that are registered and managed out of band
Tags
Annotators
URL
-
-
openvalidation.io openvalidation.io
-
Machines understand languages, that are formal and rigid, with unique and unambiguous instructions that are interpreted in precisely one way. Those formal, abstract languages, and programming languages in general, are hard to understand for humans like ourselves. Primarily, they are tailored towards the requirements of the machine. The user is therefore forced to adapt to the complexity of the formal language.
.
-
Instead of forcing humans to understand the complex inner workings of machines, we should construct machines in a way, so they better understand us humans!
.
-
-
docs.openvalidation.io docs.openvalidation.io
-
This distinguishes this grammar from other programming languages or domain-specific languages.
-
The additional content is only relevant for human readability. The machine, on the other hand, ignores this addition. Thus it is possible to express the rules in a grammatically correct way on the one hand and to give them a semantic context on the other.
-
Rules formulated with openVALIDATION are thus at the same time a formal, machine-processable specification, but also a documentation that is easy for people to understand.
-
-
github.com github.com
-
var a = document.createElement("a"); a.href = blob; a.target = "_blank"; setTimeout(function() { click(a); });
-
-
-
www.amazon.com www.amazon.com
-
Also it expects you to buy a bunch of hardware like a raspberry pi and such in order to do the project. I kind of thought there was going to be some kind of public API that acted like a virtual weather sensor but apparently we're building a real one.
-
-
www.syncfusion.com www.syncfusion.com
-
elixir-lang.org elixir-lang.org
-
elixir-lang.org elixir-lang.org
-
nice list of books
Tags
Annotators
URL
-
-
www.amazon.com www.amazon.com
-
I failed to notice that, unlike the Whiz, which has the same distribution settings as a Scotts push spreader (i.e., settings 2 - 9 with half- and quarter-steps between) and which all products you use in a spreader, Scotts or not, conforms to in their instructions for telling you what to set the spreader at, the Whirl does NOT have these settings, meaning there's no way to follow directions on the packages of products you'll be using the Whirl spreader for, not even on the packages of products made by Scotts itself. That makes knowing what to set it at total guesswork, stabbing in the dark, which, as anyone knows who has ever burned their lawn with fertilizer knows, is very risky and potentially very costly. All Scotts gives you with the Whirl, after giving a disclaimer that you must "READ AND FOLLOW ALL LABEL DIRECTIONS OF THE PRODUCT YOU ARE APPLYING," which of course you can't do because those label directions give you a spreader setting that does NOT apply to this spreader, is generic instructions that say to set it at 1 for light seed, 3 for moderate fertilizer, and 5 for heavy ice-melt, only that's all very subjective and products, like fertilizers (even Scotts' own), don't all provide the same spreader setting by type but vary, meaning one fertalizer will tell you to set a standard spreader at 3 3/4, but another will tell you to set it at 5, while if you put any fertalizer on your lawn as heavily as you put ice-melt down, which is what the Whirl suggests for ice-melt, you'll burn your lawn.
-
-
www.homedepot.com www.homedepot.com
-
Topsoil has different grades. Lower-grade topsoils are meant for filling and leveling holes and should only be used for that purpose. Higher-grade topsoils are great for conditioning or adding organic matter to the native soil. Neither grade should be used when planting.
Should not be used for planting anything?? Hmm.
-
-
gardeninguru.com gardeninguru.com
-
-
moisten mixture after spreading (promotes compaction)
compaction good?
-
-
gardeninguru.com gardeninguru.com
-
clayey
-
-
-
www.housedigest.com www.housedigest.com
- Sep 2022
-
blog.mozilla.org blog.mozilla.org
-
In other words, i18n allows applications to support and satisfy the needs of multiple locales, thus “enabling” l10n.
one feature enables the other
-
“Internationalization is the design and development of a product, application or document content that enables easy localization for target audiences that vary in culture, region, or language. Localization refers to the adaptation of a product, application or document content to meet the language, cultural and other requirements of a specific target market (a locale).”
-
-
douglasorr.github.io douglasorr.github.io
-
First, to clarify - what is "code", what is "data"? In this article, when I say "code", I mean something a human has written, that will be read by a machine (another program or hardware). When I say "data", I mean something a machine has written, that may be read by a machine, a human, or both. Therefore, a configuration file where you set logging.level = DEBUG is code, while virtual machine instructions emitted by a compiler are data. Of course, code is data, but I think this over-simplified view (humans write code, machines write data) will serve us best for now...
-
-
fonts.google.com fonts.google.com
-
Alle Menschen sind frei und gleich an Würde und Rechten
see https://www.sozial.de/alle-menschen-sind-frei-und-gleich-an-wuerde-und-rechten-geboren.html
-
-
-
infinum.com infinum.com
-
set up
.
-
-
-
stackoverflow.com stackoverflow.com
-
Yes, using custom tags. Example in Python, making the !join tag join strings in an array:
-
-
bugs.ruby-lang.org bugs.ruby-lang.org
-
@path.yield_self(&File.method(:read)).yield_self(&Parser.method(:new)) ...
-
-
Why not use map, which we already have for collections? Generally speaking, the map function isn't just about collections (though that's usually how it's used in Ruby). map is more about putting an object in a context (a block in Ruby's case), modifying the object, and returning the modified object.
-
I use only a subset of ruby that makes sense to me and I find appealing. Thankfully one can use ruby just fine without having to use everything.
not all or nothing
use just the parts you want
Tags
Annotators
URL
-
-
-
TylerRick commented
-
I ended up using a really poor hack, in my package.json, scripts: { ... "prebundle": "openapi bundle -o src/openapi.preprocessed.json spec/openapi.yaml --force --config .redocly.pre-processor.yaml 2>/dev/null && echo 'warning: errors from pre-processing step have been supressed'", "bundle": "openapi bundle -o src/openapi.json src/openapi.preprocessed.json ... }
-
-
github.com github.com
-
I don't know about you guys but I like dots on the second line when combined with indentation : # Example 1 one.two.three .four # Example 2 my_array.select { |str| str.size > 5 } .map { |str| str.downcase }
-
They require the continuation to be present at precisely next line. (I.e. you cannot put more than one in-line comment in between.)
.
-
The order of these method calls may or may not matter. With leading dots, editing is a bit easier, particularly when you need to add a new method call or change the order.
easier to edit
-
(Similar to the javascript issue, you always have to remember to remove/add the trailing comma, so some developers prefer to put 'comma' in the beginning of each property.)
-
-
-
openscad.org openscad.orgOpenSCAD2
-
The Programmers Solid 3D CAD Modeller
-
Tags
Annotators
URL
-
-
elixir-lang.org elixir-lang.org
-
Due to their lightweight nature, it is not uncommon to have hundreds of thousands of processes running concurrently in the same machine.
-
Spawn an Elixir process (not an operating system one!)
Tags
Annotators
URL
-
-
twig.symfony.com twig.symfony.com
-
-
www.syndicatetheory.com www.syndicatetheory.com
-
Do yourself and your peers a favor, write code with them in mind.
-
-
-
medium.com medium.com
-
Writing Code for Humans — A Language-Agnostic Guide…because code which people can’t read and understand is easy to break and hard to maintain.
-
-
metalblueberry.github.io metalblueberry.github.io
-
Also, the chances of breaking something are really high, because not even you remember how the code actually works.
-
Some people eventually realize that the code quality is important, but they lack of the time to do it. This is the typical situation when you work under pressure or time constrains. It is hard to explain to you boss that you need another week to prepare your code when it is “already working”. So you ship the code anyway because you can not afford to spent one week more.
-
your cognitive load increases with the level of indentation. 1 2 3 4 5 6 7 8 9 10 if r.Method == "GET" { if r.Header.Get("X-API-KEY") == key { // ok return nil }else{ return errors.New("Key is not valid") } } else { return errors.New("Invalid Method") }
-
Cognitive capacity is the total amount of information the brain is capable of retaining at any particular moment. This amount is finite, so we can say our total capacity is only ever 100%. How much of one’s cognitive capacity is being used towards a particular task at any given time is called the cognitive load
-
Any fool can write code that a computer can understand. Good programmers write code that humans can understand.
-
netstat -tn 2>/dev/null | grep :80 | awk '{print $5}' | cut -d: -f1 | sort | uniq -c | sort -nr | head
-
To see if you are writing good code, you can question yourself. how long it will take to fully transfer this project to another person? If the answer is uff, I don’t know… a few months… your code is like a magic scroll. most people can run it, but no body understand how it works. Strangely, I’ve seen several places where the IT department consist in dark wizards that craft scrolls to magically do things. The less people that understand your scroll, the more powerfully it is. Just like if life were a video game.
-
it quickly becomes a mess of non related functions that anyone but the owner feels brave enough to import
-
A little copy paste is better than a little dependency.
-
Avoid indentation levels, If you find yourself with more than 3, you should create a function.
-
Code explains what and how Documentation explains why.
-
So make sure to write your documentation, but do not explain your spells.
-
This is so clear that you don’t even need comments to explain it.
-
Another type of comments are the ones trying to explain a spell.
-
Do not explain your spells, rewrite them.
-
Do you really need those lines? Isn’t it clear enough? Well, I still find comments like this in a lot of cases and it gets funnier when the comment is obsolete and the code is doing other things. Following the example, let’s imagine that another developer adds support for PUT method. I think that this is what would happen.
-
This code is much easier to understand as it do not add levels of indentation and follows the principle where the 0 indentation level is the principal path of the application where other paths are exceptions or rare cases.
-
people usually forgets about one of the greatest advantages of Open Source. YOU can fix the issue. You can download the source code and dig deep into the code allow you to keep moving. Also, you can merge this changes back to the original repository so others doesn’t have to fix it again. win-win relationship.
-
The rule of thumbs is, never use code that you do not understand.
Tags
- maintenance burden
- fear of breaking things
- answer the "why?"
- brave
- hard to explain
- error/exception handling
- documentation: inaccurate/outdated
- misc./utility package
- one-liners
- main path
- I agree
- annotation meta: may need new tag
- pressure
- quotable
- +1.0
- source code: comments
- happy path
- error path / failure track
- cognitive load
- only the creator could truly love
- write code that humans can understand
- as the author/creator…
- open-source software: you can fix bugs yourself
- minimal dependencies
- work: manager who understands what you do
- unintentionally breaking something
- becomes outdated quickly
- open-source software: advantages of
- unrelated
- source code: comments: explain why, not what or how
- readability
- documentation: good
- cognitive capacity
- time constraints
- +0.8
- source code: avoid unneeded indentation levels
- maintainability
- easy to forget
- if you have to explain it, rewrite it to be simpler
Annotators
URL
-
-
github.com github.com
-
:w saves.
-
I used to write code. I still do, but I used to, too.
-
-
github.com github.com
-
I don't like the first syntax because then you have weird looking code due to all the leading whitespace, and you lose a lot of real estate.
-
Aligning everything with however long the method name is makes every indention different. belongs_to :thing, class_name: 'ThisThing', foreign_key: :this_thing_id has_many :other_things, class_name: 'ThisOtherThing', foreign_key: :this_other_thing_id validates :field, presence: true Compared to the following, which all align nicely on the left. belongs_to :thing, class_name: 'ThisThing', foreign_key: :this_thing_id has_many :other_things, class_name: 'ThisOtherThing', foreign_key: :this_other_thing_id validates :field, presence: true
-
This one bugs me a lot, but honestly, I don't like either style of the "normal method calls" above. I'm definitely voting to change the rule, but I'd also recommend trying to use the following syntax. In my opinion, it's the best of both worlds. a_relatively_long_method_call( :thing, :another_thing ) Or, if there are a lot or arguments, or the arguments are long: a_relatively_long_method_call( :a_long_argument, :another_long_argument, :a_third_long_argument )
-
-
medium.com medium.com
-
When I ask people about any part of their code, they usually say it's easy to understand. But when I open the code, it takes me a couple hours slapping to my face to keep myself alive to understand just a little part of their code.
-
The best book that I can recommend to any developer to shape up their attitude about programming.
-
But how much readability are enough?
-
In collusion, writing good code not only require knowledge but also require compassion. To understand people's pain and mistakes, to think about your teammate and to help everyone achieve a better life.
-
collusion
-
Think about how good it is if you can build a system at “2 half brain quality” and then people just need use 1 half of their brain to maintain it. You can fix bug in a blink of an eye, run tests and give it to tester, done. Everything will be done in a easiest way and fixing bug or refactoring can be easy like breathing. The most heavy task in programming is not about building application, but it’s about maintain them and if you wrote something you can’t understand, then you will suffer for the rest of your life.
-
they’re just too familiar with the code to think it's complicated
-
Write code for human, not for God
-
-
-
400 Bad Request is the status code to return when the form of the client request is not as the API expects.401 Unauthorized is the status code to return when the client provides no credentials or invalid credentials.403 Forbidden is the status code to return when a client has valid credentials but not enough privileges to perform an action on a resource.
-
-
Is there a problem or not?If there is a problem, on which side is it? On the client or on the server side?
-
-
github.com github.com
-
I said I wanted begin..end to follow the same indentation principles as if..end because they are semantically related (both are expressions), and I stand by that opinion.
-
-
github.com github.com
-
Hey, checking from a few months in the future here. Is there by chance an update on this issue?
-
Unfortunately, the conversation on both PRs died off (no hard feelings, people have other things going on in their lives).
-
The RuboCop way is to offer an opinion in the way of a good default, but to accommodate all reasonable style choices.
-
really begin/end is just a way to pass several expressions where you normally need to pass only one. In this way I think it's much closer to something like conditionals (e.g. if, than to do).
-
in my personal opinion, there shouldn't be a special treatment of do-end blocks in general. I believe that anything that starts a "block", i.e. something that is terminated by and end, should have the same indentation logic
-
-
stackoverflow.com stackoverflow.com
-
The point of that line was, "I tried irrelevant things and they obviously didn't work." I ate a banana while trying it- should I include that in the steps as well? The other work I did was not relevant, therefore, not mentioned explicitly outside of "I'm frustrated and just trying rubbish at this point." I could have been more clear saying that I've tried each of the available options on the 3 relevant to no avail, you are correct.
-
-
www.codementor.io www.codementor.io
-
I have a simple coding principle: write lines of code as though instructing a real person how to do the job. And that naturally expands to designing and modelling systems like real organisations with their own divisions, departments, branches, and all the various “job positions” that need to be filled. Make the whole system appear as human as possible.
-
-
Conventions are good, but they are very limited: enforce them too little and the programmer becomes coupled to the code—no one will ever understand what they meant once they are gone. Enforce too much and you will have hour-long debates about every space and colon (true story.) The “habitable zone” is very narrow and easy to miss.
-
-
-
concurrent-safe
-
The variable a is incremented thanks to the atomic memory primitives function addInt that is concurrent-safe. However, we assign the result to the same variable, which is a not a concurrent-safe write operation. This a careless mistake detected by the atomic analyzer.
first sighting: concurrent-safe
-
-
docs.openvalidation.io docs.openvalidation.io
-
The rules recorded in natural language are readable not only by humans but also by the computer and therefore no longer need to be programmed by a software developer. This task is now taken over by openVALIDATION.
-
openVALIDATION enables programming of complex validation rules using natural language, such as German or English.
-
-
rororo.readthedocs.io rororo.readthedocs.io
-
"detail": [ { "loc": [ "body", "name" ], "message": "Field required" }, { "loc": [ "body", "email" ], "message": "'not-email' is not an 'email'" } ]
not complient with Problem Details, which requires
detailsto be a string
-
-
lurumad.github.io lurumad.github.io
-
jonathancrozier.com jonathancrozier.com
-
For example, let’s consider the type property. For most of the projects I am working on, it isn’t practical to have a webpage dedicated to each type of possible error.
That's not required. The standard doesn't require this to be a URL locator — merely a URI! So you can just make up a URI and use it even if it's not resolvable. ... like you did for the URN below.
-
For the instance property, the most practical way I’ve found of implementing this is to define a URN that encapsulates additional information regarding the error. Here is an example URN for reference. urn:companyname:api:error:protocol:badRequest:f29f57d7-e1f8-4643-b226-fa18f15e9b71
-
-
steamcommunity.com steamcommunity.com
-
We decided to follow their rules to stay in their affiliate program, because that's how we are able to actually run the site (without any ads).And if you look on the issue from the usability point of view, not having their price history isn't that big of a deal, unless the game is sold only on Amazon - and most games aren't - so you always have other stores to compare the price to.
-
Hi L0ki,as we depend on retailers with affiliate programs to run the site without ads, and Amazon being one of them, yes, we are following their rules so we can use API and their affiliate program.As Tomas said, we are also trying to get the history back, though we noticed we aren't the only site being affected by this.As for ignoring their API and doing it the hard way - that could be possible I guess but really not preferable.And we also understand anybody not wanting to buy from Amazon anymore (as some already told us), but to be fair, if the game is available anywhere else (and I have yet to randomly find a game which is available only at Amazon), you can always check the game info on ITAD to compare the price to other retailers.
-
If it's not, it should be illegal for them to forbid you from showing price history. This is restricting access to information, and it's probably supposed to benefit them from shady sales (increasing the base price just before a sale, so that the "X % off" is higher).
-
"We are not allowed to show you Amazon history"? What prompted this? Fill me in if I missed something :).EDIT: Camelcamelcamel can still show Amazon price history, so a bit befuddled here.
-
I would be interested to know what the legality of this is either way. I mean, do they really have any legal right to compel you not to list their price history? However, just knowing that Amazon doesn't want you to do this will make me less likely to purchase from them in the future. Anti-consumer behavior pisses me off. Edit: If this is related to API access couldn't you just manually scrape prices off the site instead and hammer their server? Or is this more related to not wanting to bite the hand that feeds you so to speak related to the funding you can get through referral links?
-
-
blog.restcase.com blog.restcase.com
-
"type": "https://example.com/problems/request-parameters-missing"
-
-
datatracker.ietf.org datatracker.ietf.org
-
This specification reserves the use of one URI as a problem type: The "about:blank" URI [RFC6694], when used as a problem type, indicates that the problem has no additional semantics beyond that of the HTTP status code. When "about:blank" is used, the title SHOULD be the same as the recommended HTTP status phrase for that code (e.g., "Not Found" for 404, and so on), although it MAY be localized to suit client preferences (expressed with the Accept-Language request header). Please note that according to how the "type" member is defined (Section 3.1), the "about:blank" URI is the default value for that member. Consequently, any problem details object not carrying an explicit "type" member implicitly uses this URI.
annoying limitation
have to come up with unique (and unchanging?) URIs up front
otherwise (if type is omitted), this restrictive "about:blank" URI is assumed by default
-
Consumers can use the status member to determine what the original status code used by the generator was, in cases where it has been changed (e.g., by an intermediary or cache), and when message bodies persist without HTTP information. Generic HTTP software will still use the HTTP status code.
-
Likewise, truly generic problems -- i.e., conditions that could potentially apply to any resource on the Web -- are usually better expressed as plain status codes.
-
For example, a "write access disallowed" problem is probably unnecessary, since a 403 Forbidden status code in response to a PUT request is self-explanatory.
-
-
www.rfc-editor.org www.rfc-editor.org
-
-
Note that industry consortia as well as non-commercial entities that do not qualify as recognized standards-related organizations can quite appropriately register media types in the vendor tree.
not limited to comerercial
-
The media type specification and registration procedure is now a separate document, to make it clear that it is independent of MIME.
-
-
en.wikipedia.org en.wikipedia.org
-
they allow resources to be referred to without the need for a continuously available host, and can be generated by anyone who already has the file, without the need for a central authority to issue them. This makes them popular for use as "guaranteed" search terms within the file sharing community where anyone can distribute a magnet link to ensure that the resource retrieved by that link is the one intended, regardless of how it is retrieved.
Tags
Annotators
URL
-
-
auth0.com auth0.com
-
However, while URLs allow you to locate a resource, a URI simply identifies a resource. This means that a URI is not necessarily intended as an address to get a resource. It is meant just as an identifier.
However, while URLs allow you to locate a resource, a URI simply identifies a resource.
Very untrue/misleading! It doesn't simply (only) identify it. It includes URLs, so a URI may be a locator, a name, or both!
https://datatracker.ietf.org/doc/html/rfc3986 states it better and perfectly:
A URI can be further classified as a locator, a name, or both. The term "Uniform Resource Locator" (URL) refers to the subset of URIs that, in addition to identifying a resource, provide a means of locating the resource by describing its primary access mechanism (e.g., its network "location").
This means that a URI is not necessarily intended as an address to get a resource. It is meant just as an identifier.
The "is not necessarily" part is correct. The "is meant" part is incorrect; shoudl be "may only be meant as".
-
-
github.com github.com
-
pointer: type: string description: A string containing a JSON pointer to the specific field within a received JSON body that caused the problem, e.g. '/data/attributes/title' to refer to the `title` property within the `attributes` object that is a child of the top level `data` object. example: /data/attributes/title
-
-
ErrorResponse: description: Container object for one or more errors returned by the API. type: object required: - errors properties: errors: type: array items: $ref: '#/definitions/Error'
-
-
github.com github.com
-
TylerRick commented
-
I think your issue is a bug (it's different from this issue which is a feature request about the split command). I opened this issue you may want to follow: #560
-
-
github.com github.com
-
with the caveat that the split->bundle will be lossy with respect to YAML comments/format. I've thought about it more and think, "so what?" If it enables teams to be more productive, great.
-
It means it is split to an opinionated split structure.
-
I saw the repo previously, but missed the split functionality, I thought it was more like a template repo.
-
-
-
FetchErrorResponse: type: object properties: meta: $ref: '#/definitions/FetchMetaResponse' errors: $ref: '#/definitions/Error' example: { "meta": { "req_id": "d07c8b12-c95e-4a06-8424-92aac94bb445" }, "errors": [{ "code": "Unauthorized", "detail": "A valid bearer token is required", "status":"401" } ] }
-
-
github.com github.com
-
This has moved to part of the monorepo:
Tags
Annotators
URL
-
-
github.com github.com
-
There are also some advantages to a multi-file YAML format OpenAPI definition: Reuse schema objects to keep things DRY (don't repeat yourself) Smaller diffs compared to JSON (especially for markdown descriptions) Easier to navigate Easier to edit with confidence
-
-
github.com github.com
-
Filter gives me the impression of inclusion... so if I filter by fruits, I expect to see apples, oranges, and bananas. Instead, this is more like filter out fruits... remove all the fruits, and you're left with the rest. Filter in/out are both viable. One means to include everything that matches a condition, and the other is to exclude everything that does not match a condition. And I don't think we can have just one.
-
-
-
I got stuck with tests here #443 and I need to switch to other more prioritised work. Maybe somebody will take over when time allows.
-
-
github.com github.com
-
let's not mix code changes with prettier. This is a bad practise which complicates code review and history review. Let's apply prettier in a separate PR/commit.
-
-
developer.mozilla.org developer.mozilla.org
-
The server possibly can send back a 406 (Not Acceptable) error code when unable to serve content in a matching language. However, such a behavior is rarely implemented for a better user experience, and servers often ignore the Accept-Language header in such cases.
-
-
docs.openvalidation.io docs.openvalidation.io
-
x-ov-rules: culture: en rule: | the location of the applicant MUST be Dortmund
-
-
developer.mozilla.org developer.mozilla.org
-
Warning: The client should not repeat this request without modification.
-
-
www.rfc-editor.org www.rfc-editor.org
-
It is often the case that a group or "tree" of documents has been constructed to serve a common purpose, wherein the vast majority of URI references in these documents point to resources within the tree rather than outside it. Similarly, documents located at a particular site are much more likely to refer to other resources at that site than to resources at remote sites. Relative referencing of URIs allows document trees to be partially independent of their location and access scheme.
-
Relative referencing of URIs allows document trees to be partially independent of their location and access scheme.
-
-
github.com github.com
-
Would you accept a PR for the suggested change?
-
-
www.imdb.com www.imdb.com
-
There are so many movies where the directors go out and say this is a family movie, just like the whole cast of Salaam Namaste when they shouted out that its a movie for families too..but the ones that have seen it they know how Vulguar the movie was at times. But this movie is a true family movie, and Iam sure your family will enjoy it, mine did for sure.
Tags
Annotators
URL
-
-
www.rfc-editor.org www.rfc-editor.org
-
However, links between resources need not be format specific; it can be useful to have typed links that are independent of their serialisation, especially when a resource has representations in multiple formats.
-
-
assetstore.unity.com assetstore.unity.com
-
To be fair, for a $30 asset I don't really expect that much support, but the problem here is that because of the lack of docs and hard to parse and modify codebase, folks are way more dependent on the developer than for other assets with proper docs, field tooltips, and maintainable code.
-
-
developer.mozilla.org developer.mozilla.org
-
The request might or might not eventually be acted upon, as it might be disallowed when processing actually takes place.
-
-
redocly.com redocly.com
-
You can tell the lint command to validate specific API definitions by using their names from the apis object, like in the following example: Copy Copied redocly lint core@v2
Tags
Annotators
URL
-
-
redocly.com redocly.com
-
We do, You doThis tutorial is most effective when you follow along and complete the steps.
first sighting: "We do, You do"
-
-
docs.gitlab.com docs.gitlab.com
-
Rename the existing default branch to the new name (main). The argument -m transfers all commit history to the new branch: git branch -m master main
-
-
gitlab.com gitlab.com
-
Unfortunately, Wiki depends a lot on HEAD ref for its functionality, such as versions management, file collision check, etc. That causes multiple quirky behaviors. The normal project repositories don't fall into such behaviors because GitLab (Gitaly actually) has a complicated heuristic to determine the current default branch, while Wiki repository does not.
-
The fix is to unify how Git repository accesses the data.
-
-
www.pcmag.com www.pcmag.com
-
Further, all outbound communication from the FaxZero server is secured with either SSL or TLS.
outbound communication from the FaxZero server — you mean faxes? — are secured with TLS? not actually possible, hmm...
-
Snail mail can be too slow, and email isn't secure. So that leaves us with the decades-old, but still reliable, fax.
email is secure enough. Why do people keep perpetuating this myth?
-
-
json-schema.org json-schema.org
-
A workaround you can use is to move additionalProperties to the extending schema and redeclare the properties from the extended schema.
-
Because additionalProperties only recognizes properties declared in the same subschema, it considers anything other than “street_address”, “city”, and “state” to be additional. Combining the schemas with allOf doesn’t change that.
-
It’s important to note that additionalProperties only recognizes properties declared in the same subschema as itself. So, additionalProperties can restrict you from “extending” a schema using Schema Composition keywords such as allOf. In the following example, we can see how the additionalProperties can cause attempts to extend the address schema example to fail.
-
-
stackoverflow.com stackoverflow.com
-
In your scenario, which many, many people encounter, you expect that properties defined in schema1 will be known to schema2; but this is not the case and will never be.
-
When you do: "allOf": [ { "schema1": "here" }, { "schema2": "here" } ] schema1 and schema2 have no knowledge of one another; they are evaluated in their own context.
-
],
Shouldn't the allOf array include both the $ref and the local list of properties?
-
-
github.com github.com
-
unevaluatedProperties is like additionalProperties, except that it can "see through" $ref and "see inside" allOf, anyOf, oneOf, if, then, else
-
-
-
As a reminder, the JSON Schema is not the source of truth for the Specification. In cases of conflicts between the Specification itself and the JSON Schema, the Specification wins.
-
Also, some Specification constraints cannot be represented with the JSON Schema so it's highly recommended to employ other methods to ensure compliance.
-
-
github.com github.com
-
Does this mean that the schema is available now since the bug is closed?
Shouldn't have had to ask. But fortunately, link posted below
-
OK, I am really, truly, for real working on this next week. Stay tuned... and feel free to mock me if I don't get anything done
-
Changing OAS to placate JSON Schema validators is definitely a tail-wagging-the-dog scenario.
-
I found your unevaluatedProperties proposal while trying to understand what's the problem with JSON Schema for OAS 3.x. It looks like OAS 3.x would not have used x- properties if it had to produce a JSON Schema at release time. Now, you are trying to fix OAS 3.x idiosyncrasies by pushing a change to JSON Schema in a tail-wagging-the-dog move. This is fascinating ;-)
.
-
The difficulties of producing an OAS 3.0 spec without it helped validate that the keyword was needed, and not (as some claimed) a solution looking for a problem. The best feedback is always real-world usage.
-
It is very excited to see JSON Schema and OAS 3.0 Schema efforts collide in such a very constructive way. I look forward to seeing the results of your very appreciated effort!
-
Nobody expects the v3 schema to be more of a perfect guarantee than the v2 schema (as said above, consider operationId). Just release a schema and let the dice fall where they may.
-
trying to break a year-long (and counting) logjam.
.
-
I hate when one developer don't want to implement a wanted and useful feature because some other developer might "use it wrong" according to their own "dogma".
.
-
It is important to remain respectful even when through disagreement in the open source community.
.
-
my use of the schema would have nothing to do with validation but generating typescript definition and having more accurate code editor completion/suggestions.
-
One of the reasons I initially pushed back on the creation of a JSON Schema for V3 is because I feared that people would try to use it as a document validator. However, I was convinced by other TSC members that there were valid uses of a schema beyond validation.
annotation meta: may need new tag: fear would be used for ... valid uses for it beyond ...
-
the errors that you get from JSON schema can sometimes be very confusing. I wanted to be able to generate errors that could easily be understood to speed up debugging time.
-
Maybe one day, JSON Schema would be able to express all the constraints in the OpenAPI spec, but I suspect some are going to be really hard.
-
Release early, release often! One out of two won't be bad :-)
.
Tags
- validation tool
- not expressive enough
- shouldn't have had to ask
- variety of use (use cases)
- error messages: should reveal/point to why/how error was caused and how to fix/prevent it
- annotation meta: may need new tag
- cannot be expressed in _
- based on real-world usage
- useless/unhelpful/generic error messages that don't reveal why/how error was caused
- schema
- missed opportunity: link to what you are referring to
- funny
- the tail wagging the dog
- appreciation
- doesn't need to be perfect
Annotators
URL
-