ДевДоцс се придружује заједници фрееЦодеЦамп

ДевДоцс је веб апликација отвореног кода која комбинује документацију за мноштво алата за програмере у један интерфејс за претраживање.

Користим ДевДоцс још пре него што је фрееЦодеЦамп уопште постојао и током година сам га певао.

Брзина и једноставност ДевДоцс-а прави су дашак свежег ваздуха. Сваки АПИ је постављен у истој јасној хијерархији.

Дакле, када је дошло време за дизајн водича за бесплатни ЦодеЦамп прошлог лета, већ сам имао на уму јасан образац. Намеравали смо да створимо интерфејс налик ДевДоцс-у за истраживање програмских концепата.

Обратио сам се творцу ДевДоцс-а Тхибауту Цоуроубле-у за савет. Био је од помоћи у објашњавању како је ДевДоцс радио и образложењу неких од његових дизајнерских одлука.

Он и ја смо били у контакту. Разменили смо идеје како да направимо алате који ће бити приступачнији програмерима у деловима света без поузданих брзих интернет веза.

Пре неколико месеци, Тхибаут ми се обратио о могућности да донирам пројекат ДевДоцс заједници фрееЦодеЦамп, како бисмо могли да наставимо да развијамо пројекат више од онога што он може да ради као усамљени одржаватељ.

И данас - тачно 5 година након што је Тхибаут створио ДевДоцс - узбуђен сам што могу објавити да је ДевДоцс сада званично део заједнице фрееЦодеЦамп!

Кратка историја ДевДоцс-а

Тхибаут је француски програмер који сада ради као виши вођа развоја у Схопифи-у у Отави, Канада.

Тхибаут је креирао ДевДоцс пре тачно 5 година данас, 26. марта 2013. У то време је само желео бољи начин за брзи приступ документацији Мозилла Девелопер Нетворк.

Првобитно је ДевДоцс био само обична фасцикла са документацијом на његовом чврстом диску, за његову личну употребу - онакву какву су многи програмери имали при руци за референцу. Затим, после неколико месеци развоја, Тхибаут је 18. јуна 2013. године покренуо ДевДоцс као бесплатну веб апликацију.

У почетку је Тхибаут држао ДевДоцс затвореним извором. Али 24. октобра 2013, он га је отворио.

Од тада је пројекат ДевДоцс акумулирао више од 17.000 ГитХуб звезда, заједно са 66 сарадника (мада је Тхибаут и даље његов најплоднији сарадник).

Тхибаут је написао десетине скрипти за стругање како би изашао и аутоматски преузео документацију из различитих пројеката, од којих је свака пажљиво подешена како би створила доследно искуство читања и генерисала добре резултате претраге.

Током наредне две године, Тхибаут је додао многа побољшања као што су нова документација, пречице на тастатури, боља претрага, подршка за мобилне уређаје и могућност преласка на тамну тему за ноћно гледање.

Затим је 2015. године Тхибаут направио ДевДоцс потпуно функционалним ван мреже. Одједном је свако могао да преузме читав низ документације за приступ ван мреже. Све ове датотеке би се чувале у прегледачу, захваљујући паметној употреби нове технологије назване ИндекедДБ.

Почетком 2016. године Тхибаут је додао подршку за верзије. Уместо да се ограничи само на најновију верзију документације, ДевДоцс је сада почео да подржава више верзија за сваки пројекат и библиотеку.

Испоставило се да ће те две главне нове функције бити тачка преокрета у ДевДоцс-овој корисничкој бази. Пројекат је растао и постао један од најчешће коришћених алата у заједници програмера.

Ако желите да видите докле је ДевДоцс стигао у последњих пет година, упоредите ове две теме Хацкер Невс:

  1. Прва нит из јуна 2013. - углавном људи неповољно упоређују ДевДоцс са другим пројектима за документацију (од којих су многи сада угашени).
  2. Друга нит с краја 2017. године - у једној од најгласовитијих нити свих времена Хацкер Невс-а, људи хвале ДевДоцс - посебно због његове брзине. Порука је јасна: ваш пројекат не мора бити први такве врсте - само се морате држати њега и непрекидно га побољшавати и можете постати водећи.

Данас више од 100.000 програмера користи ДевДоцс као референцу сваког месеца.

Како ДевДоцс ради испод хаубе

Једно од најчешћих питања које људи постављају Тхибауту: како је ДевДоцс постао тако брз?

Тхибаут приписује брзину ДевДоцс многим факторима:

  • ДевДоцс је веб-апликација Руби са једном страницом са малом позадином.
  • Када посетите ДевДоцс.ио, након почетног учитавања странице, све наредне датотеке (укључујући датотеке са документацијом) дохваћају се путем муњевите мреже за испоруку садржаја (ЦДН).
  • Користи ГЗИП, ХТТП кеширање, предмеморију апликација, повезане и умањене ЈаваСцрипт и ЦСС
  • Нема огласа (огласи све успоравају)
  • Користи лоцалСтораге као додатни ниво кеширања неких средстава
  • Користи меморијску кеш меморију за ствари попут тренутне навигације уназад и унапред
  • Користи ИндекедДБ за локално кеширање читавих скупова документације на рачунару
  • Из документације се уклањају сва удаљена средства и непотребне ознаке, што резултира мањим датотекама
  • Користи оптимизовану претрагу на страни клијента
  • Има неблокирајући и асинхрони кориснички интерфејс
  • Садржи оптимизовано ДОМ стабло са пагинираном листом бочне траке, тако да не мора одмах да генерише 1.000 чворова
  • Има једноставан кориснички интерфејс који избегава ужитке попут сенки или анимација

Коначно, ДевДоцс не користи ниједан јКуери или било који ЈаваСцрипт оквир. Све ДОМ операције се имплементирају ручно, чинећи их што бржим. (Тхибаут каже да не би препоручио овај приступ без оквира за већину апликација, али добро функционише за ДевДоцс.)

Како се можете укључити

Тренутно тражимо страственог и искусног програмера Руби-а који је заинтересован да постане дугогодишњи сарадник ДевДоцс-а.

Такође тражимо људе заинтересоване за олакшавање доприноса ДевДоцс-у, писањем документације и рефакторизирањем кода.

Такође можете помоћи пријављивањем грешака или захтева за карактеристике које имате у програму за праћење проблема и помажући их у тријажи или исправљању.

Можете се придружити ДевДоцс цхат соби сарадника на Гиттеру и представити се.

И на крају, можете да помогнете користећи ДевДоцс и делите га са пријатељима и колегама. Следећи пут када будете требали потражити документацију, идите на ДевДоцс.ио.

Такође можете претраживати ДевДоцс помоћу укуцавања „девдоцс“ у Цхроме-ову траку за адресу и притискајући картицу. А ДуцкДуцкГо има посебну !ddкоманду да претражује и ДевДоцс.

Придружите ми се поздрављајући Тхибаута и ДевДоцс у заједници фрееЦодеЦамп цвркућући му.

Забавите се и срећно кодирање!