Skip to content

Commit e52d373

Browse files
marvimmarvim
committed
Backup update
1 parent ee89fc1 commit e52d373

File tree

190 files changed

+74293
-2104
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

190 files changed

+74293
-2104
lines changed

‎last_update

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
2024-11-26T01:58:04Z
1+
2024-12-03T02:31:16Z

‎repositories/neovim.github.io/issues/348.json

Lines changed: 196 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,11 @@
55
"author_association": "MEMBER",
66
"body": "There have been some instances where users are confused why the documentation in neovim.io doesn't work only to realize that they don't use nightly. I have a few ideas on how we could tackle this:\r\n\r\n- Allow users to choose the version for the documentation. I think a good example of this is [cmake](https://cmake.org/cmake/help/latest/index.html) (crazy, right?), where the documentation version is prominently shown at the top in an easy place.\r\n\r\n- Use the latest stable in the documentation instead of nightly. This is probably easier to implement. A problem might be that nightly users might start complaining they can't find docs for nightly features.\r\n\r\nOpen to other suggestions.",
77
"closed_at": null,
8+
"closed_by": null,
89
"comment_data": [
910
{
1011
"author_association": "MEMBER",
11-
"body": "> Use the latest stable in the documentation instead of nightly.\r\n\r\nNot in favor. The website docs allow us to make hints and other docs available via the website search (and search engines).\r\n\r\n> Allow users to choose the version for the documentation.\r\n\r\nThis would be ideal. But the HEAD docs should stay at the current paths, because:\r\n\r\n- avoids breaking URLs\r\n- avoids needing to update our [Algolia config](https://github.com/neovim/neovim.github.io/issues/310)\r\n\r\nThe version-specific docs could live at e.g. `https://neovim.io/doc/user/v0.10/`.",
12+
"body": "> Use the latest stable in the documentation instead of nightly.\n\nNot in favor. The website docs allow us to make hints and other docs available via the website search (and search engines).\n\n> Allow users to choose the version for the documentation.\n\nThis would be ideal. But the HEAD docs should stay at the current paths, because:\n\n- avoids breaking URLs\n- avoids needing to update our [Algolia config](https://github.com/neovim/neovim.github.io/issues/310)\n\nThe version-specific docs could live at e.g. `https://neovim.io/doc/user/v0.10/`.\n\nEdit: instead of the above, let's start by using `@since` annotations as much as possible, and use CSS to make those prominent, and maybe show hover info with details.",
1213
"created_at": "2024-05-14T10:44:13Z",
1314
"html_url": "https://github.com/neovim/neovim.github.io/issues/348#issuecomment-2109873239",
1415
"id": 2109873239,
@@ -27,7 +28,7 @@
2728
"total_count": 1,
2829
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2109873239/reactions"
2930
},
30-
"updated_at": "2024-05-14T10:44:13Z",
31+
"updated_at": "2024-11-27T17:38:22Z",
3132
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2109873239",
3233
"user": {
3334
"avatar_url": "https://avatars.githubusercontent.com/u/1359421?v=4",
@@ -47,11 +48,192 @@
4748
"starred_url": "https://api.github.com/users/justinmk/starred{/owner}{/repo}",
4849
"subscriptions_url": "https://api.github.com/users/justinmk/subscriptions",
4950
"type": "User",
50-
"url": "https://api.github.com/users/justinmk"
51+
"url": "https://api.github.com/users/justinmk",
52+
"user_view_type": "public"
53+
}
54+
},
55+
{
56+
"author_association": "MEMBER",
57+
"body": "Just adding that we _are_ seeing increasing confusion since people look at docs (as we tell them to) and find documentation or code examples that simply won't work for them (since they use 0.10, as we tell them to).\n\nAt the very least, we should consider adding a (floating?) disclaimer at the top of the page that this documentation refers to nightly and, if in doubt, check with `:help`.",
58+
"created_at": "2024-11-27T17:30:27Z",
59+
"html_url": "https://github.com/neovim/neovim.github.io/issues/348#issuecomment-2504428130",
60+
"id": 2504428130,
61+
"issue_url": "https://api.github.com/repos/neovim/neovim.github.io/issues/348",
62+
"node_id": "IC_kwDOAQSZx86VRopi",
63+
"performed_via_github_app": null,
64+
"reactions": {
65+
"+1": 1,
66+
"-1": 0,
67+
"confused": 0,
68+
"eyes": 0,
69+
"heart": 0,
70+
"hooray": 0,
71+
"laugh": 0,
72+
"rocket": 0,
73+
"total_count": 1,
74+
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2504428130/reactions"
75+
},
76+
"updated_at": "2024-11-27T17:30:27Z",
77+
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2504428130",
78+
"user": {
79+
"avatar_url": "https://avatars.githubusercontent.com/u/2361214?v=4",
80+
"events_url": "https://api.github.com/users/clason/events{/privacy}",
81+
"followers_url": "https://api.github.com/users/clason/followers",
82+
"following_url": "https://api.github.com/users/clason/following{/other_user}",
83+
"gists_url": "https://api.github.com/users/clason/gists{/gist_id}",
84+
"gravatar_id": "",
85+
"html_url": "https://github.com/clason",
86+
"id": 2361214,
87+
"login": "clason",
88+
"node_id": "MDQ6VXNlcjIzNjEyMTQ=",
89+
"organizations_url": "https://api.github.com/users/clason/orgs",
90+
"received_events_url": "https://api.github.com/users/clason/received_events",
91+
"repos_url": "https://api.github.com/users/clason/repos",
92+
"site_admin": false,
93+
"starred_url": "https://api.github.com/users/clason/starred{/owner}{/repo}",
94+
"subscriptions_url": "https://api.github.com/users/clason/subscriptions",
95+
"type": "User",
96+
"url": "https://api.github.com/users/clason",
97+
"user_view_type": "public"
98+
}
99+
},
100+
{
101+
"author_association": "MEMBER",
102+
"body": "> The version-specific docs could live at e.g. `https://neovim.io/doc/user/v0.10/`.\n\nInstead of this, let's double-down on the `@since` annotations, at least to start with. And we can make those more prominent via CSS.\n",
103+
"created_at": "2024-11-27T17:37:01Z",
104+
"html_url": "https://github.com/neovim/neovim.github.io/issues/348#issuecomment-2504439457",
105+
"id": 2504439457,
106+
"issue_url": "https://api.github.com/repos/neovim/neovim.github.io/issues/348",
107+
"node_id": "IC_kwDOAQSZx86VRrah",
108+
"performed_via_github_app": null,
109+
"reactions": {
110+
"+1": 0,
111+
"-1": 0,
112+
"confused": 0,
113+
"eyes": 0,
114+
"heart": 0,
115+
"hooray": 0,
116+
"laugh": 0,
117+
"rocket": 0,
118+
"total_count": 0,
119+
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2504439457/reactions"
120+
},
121+
"updated_at": "2024-11-27T17:37:19Z",
122+
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2504439457",
123+
"user": {
124+
"avatar_url": "https://avatars.githubusercontent.com/u/1359421?v=4",
125+
"events_url": "https://api.github.com/users/justinmk/events{/privacy}",
126+
"followers_url": "https://api.github.com/users/justinmk/followers",
127+
"following_url": "https://api.github.com/users/justinmk/following{/other_user}",
128+
"gists_url": "https://api.github.com/users/justinmk/gists{/gist_id}",
129+
"gravatar_id": "",
130+
"html_url": "https://github.com/justinmk",
131+
"id": 1359421,
132+
"login": "justinmk",
133+
"node_id": "MDQ6VXNlcjEzNTk0MjE=",
134+
"organizations_url": "https://api.github.com/users/justinmk/orgs",
135+
"received_events_url": "https://api.github.com/users/justinmk/received_events",
136+
"repos_url": "https://api.github.com/users/justinmk/repos",
137+
"site_admin": false,
138+
"starred_url": "https://api.github.com/users/justinmk/starred{/owner}{/repo}",
139+
"subscriptions_url": "https://api.github.com/users/justinmk/subscriptions",
140+
"type": "User",
141+
"url": "https://api.github.com/users/justinmk",
142+
"user_view_type": "public"
143+
}
144+
},
145+
{
146+
"author_association": "MEMBER",
147+
"body": "But that won't work with current \"soft deprecations\" which _hide_ the documentation. (In this case, users will find no docs for them: the old ones are gone, but the new shown ones are inapplicable.)",
148+
"created_at": "2024-11-27T17:39:42Z",
149+
"html_url": "https://github.com/neovim/neovim.github.io/issues/348#issuecomment-2504444354",
150+
"id": 2504444354,
151+
"issue_url": "https://api.github.com/repos/neovim/neovim.github.io/issues/348",
152+
"node_id": "IC_kwDOAQSZx86VRsnC",
153+
"performed_via_github_app": null,
154+
"reactions": {
155+
"+1": 0,
156+
"-1": 0,
157+
"confused": 0,
158+
"eyes": 0,
159+
"heart": 0,
160+
"hooray": 0,
161+
"laugh": 0,
162+
"rocket": 0,
163+
"total_count": 0,
164+
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2504444354/reactions"
165+
},
166+
"updated_at": "2024-11-27T17:39:42Z",
167+
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2504444354",
168+
"user": {
169+
"avatar_url": "https://avatars.githubusercontent.com/u/2361214?v=4",
170+
"events_url": "https://api.github.com/users/clason/events{/privacy}",
171+
"followers_url": "https://api.github.com/users/clason/followers",
172+
"following_url": "https://api.github.com/users/clason/following{/other_user}",
173+
"gists_url": "https://api.github.com/users/clason/gists{/gist_id}",
174+
"gravatar_id": "",
175+
"html_url": "https://github.com/clason",
176+
"id": 2361214,
177+
"login": "clason",
178+
"node_id": "MDQ6VXNlcjIzNjEyMTQ=",
179+
"organizations_url": "https://api.github.com/users/clason/orgs",
180+
"received_events_url": "https://api.github.com/users/clason/received_events",
181+
"repos_url": "https://api.github.com/users/clason/repos",
182+
"site_admin": false,
183+
"starred_url": "https://api.github.com/users/clason/starred{/owner}{/repo}",
184+
"subscriptions_url": "https://api.github.com/users/clason/subscriptions",
185+
"type": "User",
186+
"url": "https://api.github.com/users/clason",
187+
"user_view_type": "public"
188+
}
189+
},
190+
{
191+
"author_association": "MEMBER",
192+
"body": "> But that won't work with current \"soft deprecations\" which _hide_ the documentation\n\nThey will be on deprecated.txt ?",
193+
"created_at": "2024-11-28T14:49:34Z",
194+
"html_url": "https://github.com/neovim/neovim.github.io/issues/348#issuecomment-2506293634",
195+
"id": 2506293634,
196+
"issue_url": "https://api.github.com/repos/neovim/neovim.github.io/issues/348",
197+
"node_id": "IC_kwDOAQSZx86VYwGC",
198+
"performed_via_github_app": null,
199+
"reactions": {
200+
"+1": 0,
201+
"-1": 0,
202+
"confused": 0,
203+
"eyes": 0,
204+
"heart": 0,
205+
"hooray": 0,
206+
"laugh": 0,
207+
"rocket": 0,
208+
"total_count": 0,
209+
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2506293634/reactions"
210+
},
211+
"updated_at": "2024-11-28T14:49:34Z",
212+
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/comments/2506293634",
213+
"user": {
214+
"avatar_url": "https://avatars.githubusercontent.com/u/1359421?v=4",
215+
"events_url": "https://api.github.com/users/justinmk/events{/privacy}",
216+
"followers_url": "https://api.github.com/users/justinmk/followers",
217+
"following_url": "https://api.github.com/users/justinmk/following{/other_user}",
218+
"gists_url": "https://api.github.com/users/justinmk/gists{/gist_id}",
219+
"gravatar_id": "",
220+
"html_url": "https://github.com/justinmk",
221+
"id": 1359421,
222+
"login": "justinmk",
223+
"node_id": "MDQ6VXNlcjEzNTk0MjE=",
224+
"organizations_url": "https://api.github.com/users/justinmk/orgs",
225+
"received_events_url": "https://api.github.com/users/justinmk/received_events",
226+
"repos_url": "https://api.github.com/users/justinmk/repos",
227+
"site_admin": false,
228+
"starred_url": "https://api.github.com/users/justinmk/starred{/owner}{/repo}",
229+
"subscriptions_url": "https://api.github.com/users/justinmk/subscriptions",
230+
"type": "User",
231+
"url": "https://api.github.com/users/justinmk",
232+
"user_view_type": "public"
51233
}
52234
}
53235
],
54-
"comments": 1,
236+
"comments": 5,
55237
"comments_url": "https://api.github.com/repos/neovim/neovim.github.io/issues/348/comments",
56238
"created_at": "2024-05-14T09:48:05Z",
57239
"events_url": "https://api.github.com/repos/neovim/neovim.github.io/issues/348/events",
@@ -75,23 +257,28 @@
75257
"number": 348,
76258
"performed_via_github_app": null,
77259
"reactions": {
78-
"+1": 1,
260+
"+1": 2,
79261
"-1": 0,
80262
"confused": 0,
81263
"eyes": 0,
82264
"heart": 0,
83265
"hooray": 0,
84266
"laugh": 0,
85267
"rocket": 0,
86-
"total_count": 1,
268+
"total_count": 2,
87269
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/348/reactions"
88270
},
89271
"repository_url": "https://api.github.com/repos/neovim/neovim.github.io",
90272
"state": "open",
91273
"state_reason": null,
274+
"sub_issues_summary": {
275+
"completed": 0,
276+
"percent_completed": 0,
277+
"total": 0
278+
},
92279
"timeline_url": "https://api.github.com/repos/neovim/neovim.github.io/issues/348/timeline",
93280
"title": "docs: user can select version (instead of HEAD/nightly)",
94-
"updated_at": "2024-05-14T10:45:08Z",
281+
"updated_at": "2024-11-28T14:49:36Z",
95282
"url": "https://api.github.com/repos/neovim/neovim.github.io/issues/348",
96283
"user": {
97284
"avatar_url": "https://avatars.githubusercontent.com/u/33953936?v=4",
@@ -111,6 +298,7 @@
111298
"starred_url": "https://api.github.com/users/dundargoc/starred{/owner}{/repo}",
112299
"subscriptions_url": "https://api.github.com/users/dundargoc/subscriptions",
113300
"type": "User",
114-
"url": "https://api.github.com/users/dundargoc"
301+
"url": "https://api.github.com/users/dundargoc",
302+
"user_view_type": "public"
115303
}
116304
}

0 commit comments

Comments
 (0)