Could someone have a look at this python-related "delete-edit": docs-beta.stackexchange.com/documentation/proposed/changes/… I think my example provided valuable input over the current example and highlights the inter-library part that is (almost always) missing in official documentations. I would feel bad rejecting that edit myself. :-)
Any thoughts on how something like "Parsing JSON" should be handled? This is a hot topic, and in Swift, there are several libraries that people commonly use for it. Should they all be separate examples under one topic (in which case the Parameters section doesn't really make sense)? docs-beta.stackexchange.com/documentation/proposed/changes/1567
Someone else has probably complained about this already, but the tour doesn't really make sense, and that's the first place I visited. Maybe just redirect to the "Intro Post" for the duration of the beta?
Yeah, I tried to add "guava" (I guess "Guava Library" would be better). I get a little pop-up text box to type in, but when I hit enter nothing happens. I think that's just not implemented yet.
Just wanted to say... the way I am seeing this implemented on the beta site is really leveling up my hopes from this. It is fantastic. Huge props to you guys. The meta posts on StackOverflow and the screenshots didn't speak as much as the site itself does.
3
Also, I probably sadly won't be able to contribute for this and the next week. (@Neal I am sure you'll be a champion in the JS area! Hope to join you soon :D)
@Thomas If you place it as a question in Q&A and tag it [bug], it will allow us to track it better than chat.
@JeffreyBosboom we're working on a better version of that. It's a placeholder at the moment.
@DanHulme improvements to that flow are on their way, but please feel free to make suggestions in Q&A, would love to hear any suggestions you might have.
@JeffreyBosboom you can't hit "enter" from that box. When you type, it searches through existing tags with no documentation or a proposal, and you can click one from the list. The problem is, there's no "no results" GUI, so if there are no results, you can't see why nothing is happening.
When editing a topic and either trying to submit for review or save the draft, I get an error notification, but without text:
The topic was Java: Overriding methods which I previously flagged for improvement. This happens both when the improvement checkboxes are selected and not selected.
We currently have two ways of dealing with problematic topics. First, they're reviewed, and you can reject a change with a short message, optionally suggesting a further edit to bring it in line. This works fine for the case of a simple typo, but not a large change potentially containing several ...
@user1803551 Yea... this is silly,if as soonas the edit is completed you cannot comment anymore, and you cannot respond to comments, how are we supposed to fix anything?
Is there really a need to document basic math?
For example: http://docs-beta.stackexchange.com/documentation/javascript/203/arithmetic-math/756/addition
I think that addition subtraction etc has really nothing to do with a language construct as that is a standard in Math in general.
@user1803551 I don't think anyone got agitated because you raised a concern. I think people got agitated because what you wrote made it look like SE had appointed you Topic Deleter General
@Neal my answer would be "no", but i observed that once they are created they will get many upvotes and won't get deleted. it's similar to SO when someone asks "how to convert <primitive 1> to <primitive 2> and the answer and question gets 5 upvotes in 2 minutes :)
@Neal I think adding them doesn't hurt - but if folks are willing to spend time on such things, then stopping them is likely to hurt. I'd personally focus my contributions on other important things though.
but some languages share some standards. I don't think we can choose not to have a topic in a language just because it is shared with some other languages
either the Operators topic is viable in all languages on docs, or in none. that's how I see it
I mean... kind of. most C style languages do it one way. Like, there aren't major (any?) differences between C, C++, PHP, Java, Javascript, Python, etc.
it kind of depends on how basic the community wants this to be, right? Like, addition is pretty much the easiest thing in the world to look up, and is probably one of the first things you do in any language. Is it worthwhile to document it here? Ehhhh, I don't know.
@DanHulme actually, how often was any topic deleted? i'm looking at the dates and i can't find anything which was deleted and recreated since i came to docs (though i didn't look now at all the topics)
Does anyone have any ideas/links to discussions/questions for the topic of consistency? Just thinking that really good docs are internally consistent, and if we have 100s of cooks in a single tag then might get very inconsistent, very quickly.
This 1 vote to approve/reject edits is strange. I wanted to edit an example, Person A rejected because it changed too much, so I created a seperate example, Person A approves, then another person says it's nonsense to have a seperate example and delete-edits it, Person A approves. Another person changes the original example to roughly what I had done in the first step and Person A approves. I'm speechless ...
Agreed with @MSeifert ... it's a little too easy for a random person to approve/reject anything. Granted, this is partially because the community is so small right now and there's no way to have permissions based on reputation since no one has reputation.
Early on we didn't want to do that because there were fewer people in the private beta. Now that it's growing and getting closer to public beta, it will likely be adjusted in the near future. (How soon, not exactly sure.)
Is there a way to make versions that are excluded from the per-topic version selector thingy? For example, I want to include "development began" for historical interest, but it's not worth appearing as a selectable version. docs-beta.stackexchange.com/documentation/swift/202/…
When editing a topic and either trying to submit for review or save the draft, I get an error notification, but without text:
The topic was Java: Overriding methods which I previously flagged for improvement. This happens both when the improvement checkboxes are selected and not selected.
Is there really a need to document basic math?
For example: http://docs-beta.stackexchange.com/documentation/javascript/203/arithmetic-math/756/addition
I think that addition subtraction etc has really nothing to do with a language construct as that is a standard in Math in general.
