sOwlO Ответов: 3

Минусы документации по C#

Я программирую уже несколько месяцев. И я не понимаю, почему документация для c# так плоха! Разве так бывает с каждым языком?

Когда я ищу ответы, я всегда должен искать их в другом месте, а не в документах. Я почти всегда нахожу ответы на некоторых любительских сайтах о c#. Но никогда в документации. Например: если я хочу изменить существующее приложение (текстовый блок или что-то еще), в документации об этом нет ни единого слова.

Так что я как нищий. Я спрашиваю людей с опытом. Вы начали с чтения документации? Было ли это действительно полезно? Или я не один, кто этого не понимает.

Что я уже пробовал:

Кстати. кто там использует эти устаревшие видео? Кто пишет строки, как они есть?! Может быть, когда-то его использовали, но сейчас? Это очень сложно, и вы можете написать это намного проще. У Microsoft не хватает денег, чтобы обновить эти видео с документацией, или что?

Ravi Bhavnani

> Я программирование в течение нескольких месяцев.
Подождите, пока вы не будете программировать в течение 35 лет. Со временем вы поймете, что в этой области вы должны сами во всем разобраться. Разработка программного обеспечения-это не такая деятельность, как покраска заборов или приготовление тостов (без обид на художников-фехтовальщиков и создателей тостов). Это не то, что вы получаете в короткие сроки, просматривая видео или читая несколько статей на веб-сайте.

/Рави

F-ES Sitecore

"Я программирую в течение нескольких месяцев" - ЛОЛ, да, это очевидно :) Код с технологиями Microsoft в течение нескольких лет, а затем переключитесь на технологии, отличные от Microsoft, и посмотрите, по-прежнему ли вы считаете, что MS имеет плохую документацию :)

BillWoodruff

Вы еще не в том месте, где вы можете иметь разумное мнение о документации; потому что документация не держит вас за руку и не отвечает вашим непосредственным потребностям, вы ноете и жалуетесь.

Купи несколько хороших книг, начни учиться. Ожидайте разочарования. CodeProject полон замечательных ресурсов, которые помогут вам учиться, включая списки хороших книг, некоторые из которых бесплатны.

3 Ответов

Рейтинг:
20

phil.o

Документация-это просто техническая информация об объектах и структурах фреймворка; она не привязана к C#, поскольку существуют другие языки, использующие тот же фреймворк.
Документация-не лучший выбор для изучения языка C#.

If I had to make an analogy, think about a spoken language, on one side, and a dictionary of that language, on the other. The dictionary is not meant to teach you the language; it is used to get a meaning, validate it, find synonyms, etc. Noone will ever try to learn a language by solely reading a dictionary, that would be absolute insanity. This is the same for C# and the documentation of the framework. If you want to learn C#, you have to study its syntax and grammar, its keywords, looping structures, conditional statemets, etc. When you have acquired the knowledge of the language, then you will be able to take advantage of the documentation.

Как бы то ни было, я должен это признать .Сетевая документация далека от оптимальной, некоторые части все еще являются просто универсальными заполнителями, которые не приносят никакой полезной информации.

sOwlO

Спасибо за вашу реакцию. Я проголосовал за пять. Но я слышал какого-то парня постарше. И он сказал, что они должны были узнать все из документации в Basic, еще в те дни. Потому что там не было учебников и т. д. Так почему бы не сделать документацию заниженной и применимой? А эти устаревшие видео? Со струнами? Они должны восстановить его! С их деньгами они могут себе это позволить.

phil.o

Спасибо за Ваш голос.
Я выучил basic в начале восьмидесятых из языкового руководства моего компьютера, Texas Intruments TI99-4A. Это руководство описывало только формальную грамматику и синтаксис с несколькими примерами, но не было исчерпывающим рецептом о любом требовании, которое человек мог бы даже подумать. Я купил специализированную прессу, чтобы получить более подробные примеры того, что можно сделать и как.
Старший парень, о котором вы говорите, может страдать от синдрома "раньше было намного лучше".
Я не понимаю, что вы подразумеваете под "этими видео", "со струнами". Какие видео? Какие нити?
Я бы также добавил, что язык-это не единственное, что нужно изучать: общие алгоритмические структуры данных, диаграммы также очень важны для изучения, и они не привязаны к какому-либо конкретному языку.

MadMyche

+5 и здесь тоже.
Основная документация на сегодняшний день ничем не хуже той книги, которая шла вместе с IBM PC 35 лет назад. Все, что он давал вам, - это команда и основное ее использование. Программист должен был связать команды и переменные вместе, чтобы получить конечный результат.
На самом деле ни одна языковая ссылка не может знать, какую комбинацию вы придумали, а тем более как ее изменить.
И я согласен, что любой может опубликовать что-то о том, как, по его мнению, все должно быть сделано. И очень часто это мусор.

phil.o

Спасибо :)

Maciej Los

Хорошо объяснил!

phil.o

Спасибо :)

BillWoodruff

+5 очень четкий ответ на своего рода не вопрос/напыщенную речь.

phil.o

Спасибо :)

Рейтинг:
2

Maciej Los

В отличие от недостатков... Все не так уж плохо...

Можно отметить несколько положительных аспектов документации по языку программирования (на основе Класс кортежей[^]):
1. там вы найдете определение класса/метода/события: public static class Tuple
2. в нем содержится информация о:
  пространство имен: System
  б) библиотека/собрание: System.Runtime.dll
  в) описание того, для чего предназначен этот класс/метод/событие и что он делает (Примечания): A tuple is a data structure that...
  d) версия фреймворка (применяется к):

.NET
5 Preview 1
.NET Core
3.1 3.0 2.2 2.1 2.0 1.1 1.0
.NET Framework
4.8 4.7.2 4.7.1 4.7 4.6.2 4.6.1 4.6 4.5.2 4.5.1 4.5 4.0
...

3. Пример кода (в большинстве случаев)
4. ссылки на другие источники (see also)

Без документации мы не сможем найти эту основную информацию.

Наконец, я должен признать, что было бы гораздо лучше увидеть больше деталей, больше примеров и т. д. К счастью, в сети есть тонны учебников, статей, советов.

Рейтинг:
0

RickZeeland

Проблема с этим .Сеть состоит в том, что существует много документации, но также много плохой или старой документации.
Может быть, вы найдете что-нибудь здесь: ресурсы в освоении-нет[^]
лучшие ресурсы-для-программирования-для начинающих в освоении-с[^]