Comments (2)
Original comment by Michael Granger (Bitbucket: ged, GitHub: ged).
I will try take this ticket as constructively as possible, but with the wording as-is I'm inclined to just close this as WONTFIX. There absolutely is documentation, so to start off with a peevish declaration like "There's no documentation" is unhelpful at best.
I'm not sure why the rdoc isn't building for you, but every method is documented in detail. I will assume that you've just given it the same amount of effort that you've spent writing this ticket (which is to say a minute at best) and ignore that bit. If you have something actually constructive to say about the API docs, I'd be happy to address whatever issues you have with them.
As for your assertion that "documentation should just be online": I'm curious to what authority you're appealing. You seem to think that my spending my free time maintaining this gem somehow obliges me to also provide you with an online documentation service, which I simply reject. I owe you exactly nothing. If I hadn't had my idealism drummed out of me by people of your ilk in the past, I'd actually be inclined to think that it is you who owe me: the courtesy of civil discourse about how the fruits of my labor didn't meet your expectation at a minimum, and some modicum of effort to help remedy the problem by contributing back if you're able. I've given up that idea, because it seems that a not-insignificant part of what used to be a community of enthusiastic, helpful, polite people has been infected with a raft of pessimistic, entitled, whiny dilettantes looking for a handout and bitching when it needs a bit of assembly or reading.
So here's what I'll do, as my time allows:
I'll start work on a higher-level manual that will serve as a "getting started" document. Documentation is hard, thankless work, and it's not nearly as satisfying as working on the code, so it's going to take some time.
I'll provide links to several different places where the API documentation is published on the wiki of this site in hopes that Google will pick it up and it'll be easier to find via Google.
Hopefully that will be enough.
from ruby-pg.
Original comment by Michael Granger (Bitbucket: ged, GitHub: ged).
I've now made the changes to the wiki page on this site, and I've opened <<issue 79>> to track progress on the manual.
from ruby-pg.
Related Issues (20)
- How to build an old pg on ruby 2.3.1 HOT 1
- Segmentation fault with ruby 2.7.8 and pg 1.5.3 HOT 10
- Segmentation fault HOT 28
- Sonoma: getaddrinfo segmentation fault HOT 2
- Segmentation fault in ruby:3.2.2-alpine3.18 docker image HOT 2
- Wrong binary conversion on x86 (32bit intel) arch causing test failures HOT 4
- Bad IAM Token against Amazon Aurora Postgres: Out of memory error HOT 2
- Attempting to execute a sql file with `\set ...` raises errors HOT 3
- conn.exec writing "INFO" statements to stderr instead of stdout HOT 2
- Segfault on ruby 3.2.2, pg 1.5.4 HOT 2
- Error ruby(39749,0x1e1f05300) malloc: double free for ptr 0x13c6bfa00 HOT 1
- Segmentation fault when connecting to RDS HOT 11
- Broken links in documentation HOT 3
- connection.reset don't check again DNS HOT 6
- Usage with ApacheAGE for Postgresql HOT 2
- Add BigDecimal to gemspec for Ruby 3.3/4 HOT 2
- Binary Windows gem no longer available for Ruby v3.3 since v1.5.6 HOT 2
- Test failure with modified `RUBY_PG_TEST_DIR` HOT 2
- Q: Is it possible to handle composite values like `row(123, 'str', true)` ? HOT 1
- Dereference of null in alloc_query_params HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from ruby-pg.