last day (615 days later) » 

Boop
 
Hi. I was hoping to start off with a bunch of oneboxes for the github repo I made a while back for this stuff
...actually it's better to have explanation in the same comment anyway.
 
Hi. What an excellent room, great initiative!
 
This is my repository for "workshopping" canonical questions: https://github.com/zahlman/so-workshop/
Each folder represents what I imagine to be a common question where the canonical is missing, not clearly identified (there are multiple candidates), needs improvement etc.
4
For each, I start with a discussion.md following a template, explaining the issue. I may also include the Markdown for questions that are candidates as a canonical - in these cases the format is: title, horizontal rule, question. Or I might include attempts at writing a new canonical from scratch (with another horizontal rule, followed by my attempt at the answer)
when I'm satisfied I'll add some kind of note (maybe resolution.md) indicating what changes were made and which post is the new canonical for the question.
 
Make SO Great Again!
:P
(the SO Python related questions part)
 
11:11 PM
Current projects: basic_serialization - something to talk about how to approach writing data to a file, in a way that makes it possible to recover structured data. It could be a question in itself, but also a signpost for basic questions about CSV, JSON etc. The main topic is conceptual: understanding that a file can only contain raw bytes, so we need some kind of scheme to impose meaning on that data.
common_json_syntax_errors - things that can go wrong writing JSON by hand, or with broken tools. Some basic advice on debugging - stuff like "oh the problem is at line 2 column 1? maybe you actually have JSONL"
comparing_multiple_things - people talk about "comparing" all the time in a rather vague way, but the point is to a) show technique for any, all and list comprehensions; b) highlight special cases (e.g. "is any of these things equal to X" -> "is X a member of that set").
comprehensions_and_generators_reference - not sure what I want here; I feel like I'm gathering notes for instead, but tag wikis don't get noticed, and other languages have list comprehensions.
function_closures - this is more or less resolved; I have worked on stackoverflow.com/questions/2295290 (where the more theoretical take seems appropriate) and stackoverflow.com/questions/3431676 (for more practical/debugging-oriented stuff) as canonicals, and redirected tons of other closures to them already. But it's not clear to me still whether these are really separate questions.
(I also have been using some more specific versions, such as stackoverflow.com/questions/10865116. I think stackoverflow.com/questions/6920302 is a clearly separate question, but in some cases with the Tkinter cases, that information is needed)
(there's also stackoverflow.com/questions/14413946 for implementation details, but the question isn't great - would rather have something that directly asks along the lines of e.g. "I wrote this decorator that returns a nested function that uses nonlocal; how is it actually remembering the closed-over variable after returning?)
get_results_from_a_function - I am ready to resolve this one, though not in the way I originally expected. The goal was to find something that clearly asks "just how do I get the information back when I call the function", in a general enough way to show all techniques. I eventually found stackoverflow.com/questions/3052793, which after my cleanup is (IMO) clearly better than anything else I was able to find; and I wrote my own authoritative answer there.
import_error_signpost - just a stub, but I am working on something to categorize the various possible reasons for an ImportError and give a checklist for importing stuff in Python (also tons of signpost links).
 
Suggestion: the so-called canonical questions exposed at (FAQ part) could be investigated further. There may be better canonical questions concerning them.
 
python_forward_declarations - I found a few questions like this; it's not very high priority but sometimes there are questions about wanting to "forward declare" a function. I have a few notes already. This ties into some UnboundLocalError questions probably
write_lines_to_a_file - there, somehow, doesn't seem to be a good, simple question that explains how to write a list of strings to a file, each on a separate line.
@Marco do you mean, in the Python tag wiki?
or on sopython.com, or something else
 
11:28 PM
It is in the info page part of the tag, actually
 
Yes, that is what we call "the tag wiki"
 
Yes
I wrongly linked that, sorry
 
to my understanding, anyone can propose an edit; 5000 reputation is required to approve edits
I want to petition on Meta for tools to make the tag wiki more useful... except I don't really know what the tools would be.
 
If I might give some feedback before bed. That giant block of text is intimidating if I were to join a room. I understand the desire to spell out where you're up to, but that's a lot of info - I'm not sure people will pick through it. That's quite a heavy launch for the room and requires people to pick up from where you're currently at
 
@KarlKnechtel Interesting
@KarlKnechtel Nice
 
11:32 PM
certainly, they need to be a lot more visible (discoverable)
@roganjosh newcomers to the room will see the most recent messages first, yes? so I can just try again
 
@roganjosh Perhaps. There could be a guide about the room, and a link to it displayed in the room description.
 
@Marco That's easier said than done; you know that sopython is a maintained website etc. etc.?
 
I can pin a proper introduction after writing it
 
@KarlKnechtel Correct, so my messages are perhaps good noise and it works if it gives you something to link back to :)
 
this is the fun part, figuring it all out on the fly
 
11:34 PM
@roganjosh Of course
 
@KarlKnechtel well, you have your references down now, so you have your chat links to hand
 
the workshop has a README
 
Done
 
(there are more workshops I haven't put in the repo yet... still at the link-gathering stage; but I at least got things bookmarked and the bookmarks organized in folders, locally, so I don't have hundreds of browser tabs open.)
I suppose the repository could also, separately, house guidance for using this room.
 
Perfectly
 
11:38 PM
In any case @KarlKnechtel, I suggested in Room 6 that you have another go at launching this room and I'll pin it (I know your focus has been here). The current message that has a few stars has no context so it's pointless to pin that. I have about 5 mins before bed, or I'll pick it up in the morning :)
 
have a good night, I will definitely want to think about this more carefully
 
Oki doki. Good night and congratz on your new room :)
 
@KarlKnechtel in the future it can become a GitHub page: docs.github.com/en/pages/getting-started-with-github-pages/…
Good night everyone!
@roganjosh I just thought of a content from Karl's own GitHub repository. Which he already mentioned.
Congratz on your new room, Karl!
 
room topic changed to python-canon-discussion: A community-driven effort to identify, clean up and promote canonical Python questions. GitHub repository: github.com/zahlman/so-workshop [python] [python-2.x] [python-3.x]
I think what I'll do is, expand and refactor the README content on the repository, and then have the link in the title directly point at that. Then I can write a welcome message and pin it instead
 
Excellent
 
11:51 PM
room topic changed to python-canon-discussion: A community-driven effort to identify, clean up and promote canonical Python questions. GitHub repository: github.com/zahlman/so-workshop Community wiki for promoting canonicals: sopython.com/canon [python] [python-2.x] [python-3.x]
 

  last day (615 days later) »