API reference & community content, Книги та статті, Різне, статті

У пакет розробника (SDK) версії 4.3 включена довідкова документація у форматі CHM, що містить описи класів і методів об’єктної моделі платформи:



Найближчим часом буде також випущена додаткова довідка WorkflowReference.chm, що включає в себе описи класів з зборок DocsVision.Workflow.Runtime (об’єктна модель ядра Workflow) і DocsVision.Workflow.Gates (Об’єктні моделі стандартних шлюзів).

Ці довідкові керівництва генеруються автоматично на підставі скомпільованих збірок та коментарів до методів з вихідного коду. Тому не слід шукати там шляхи вирішення конкретних задач, приклади коду, поради, і. д. – Для цієї мети, як і раніше служить окремий документ – “Керівництво розробника на платформі DocsVision”. Скоріше, слід розцінювати їх як спосіб швидко подивитися сигнатуру тих чи інших методів; відстежити взаємозв’язку класів; уточнити значення перерахувань; і т.д. В цьому сенсі, довідкові керівництва зараз аналогічні по функціональності простому браузеру об’єктів (натиснути F2 в Visual Basic 6, або Ctrl + Alt + J в Visual Studio 2005-2008) …

Але з часом ми розраховуємо доповнювати дані довідкові керівництва, і розширювати їх тими самими описами, порадами, прикладами коду (аналогічно http://msdn.microsoft.com/) – а документ “Керівництво розробника на платформі “скасувати.

Однак, це тривала і складна робота (тому що обсяг документації дуже великий), і тому ми покладаємо надії на допомогу співтовариства в цій справі. З цією метою, в довідкові керівництва включений так званий community content – можливість всім читачам залишати свої коментарі до статей, задавати питання, писати відповіді (приблизно також, як це робиться в блозі). За допомогою даного інструменту стане можливим поповнення документації зусиллями партнерів, обмін досвідом між ними безпосередньо – без використання посередників у вигляді форумів або цього блогу. І в кінцевому рахунку, вигідно це буде всім.

Функції community content включають в себе:

1) Можливість залишати публічні (видимі всім), або особисті (видимі тільки автору) нотатки до будь-якої статті, а також переглядати публічні коментарі інших читачів:



2) Можливість фільтрувати відображаються коментарі:



3) Можливість оцінювати корисність статей за допомогою рейтингу:


Для написання коментарів, потрібна мінімальна реєстрація (ім’я, пароль). Реєстрація наскрізна на всю документацію (не потрібно окремої реєстрації на кожне керівництво).

Всі коментарі до документації будуть модеруватись нами, з метою виключення спаму і не відносяться до справи обговорень.

Увага! Дана послуга поки запущена нами в тестовому режимі, з метою вивчення її затребуваності і актуальності. У зв’язку з цим, можливі перебої в її роботі, або зникнення залишених коментарів. Просимо поставитися до цього з розумінням. При високому ступені затребуваності даної послуги, вона буде розвиватися і вдосконалюватися.

Схожі статті:


Сподобалася стаття? Ви можете залишити відгук або підписатися на RSS , щоб автоматично отримувати інформацію про нові статтях.

Коментарів поки що немає.

Ваш отзыв

Поділ на параграфи відбувається автоматично, адреса електронної пошти ніколи не буде опублікований, допустимий HTML: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

*

*